App metadata

The application metadata document holds technical information about the app and the data type requirements.

Application

The Application model is the main model for metadata for the application.

Name	Description
id	A gobally unique id for the application. The value has two parts separated by a ‘/’ character. The first part is the short name of the application owner and the second part is the name of the app.
versionId	The current version of the application. (Currently not in use.)
org	The short name of the application owner.
title	A collection of the application title in different languages.
validFrom	The date and time from when the application can be used to create instances.
validTo	The data and time for when the application will expire and can no longer be used to create new instances.
processId	The id of the process model being used by the application. (Currently not in use.)
dataTypes	A list of all the data types associated with the application. See DataType.
partyTypesAllowed	A collection of flags that controls what type of instance owners new instances can be created for. See PartyTypesAllowed
autoDeleteOnProcessEnd	A value indicating whether an instance will be automatically deleted once the process ends. This can be used by highly sensitive applications to force an instance delete instead of sending the instance to the archive.
presentationFields	A collection of presentation fields. See PresentationField. Currently not in use.
dataFields	A collection of data fields. See DataField.
eFormidling	The configuration for the eFormidling integration for the application. See eFormidlingContract.
messageBoxConfig	A collection of configurations related to the Altinn Message box

DataType

Data type represents the requirements for data elements. Data types representing a form will have model validation in addition to the requirements defined here.

Name	Description
id	The id of the data type. Unique for the app.
description	A collection of data type descriptions in different languages.
allowedContentTypes	A list of Content-Types allowed by the data type.
allowedContributers	A list of allowed contributors. This can be used to restrict who it is that can work with the data type.
appLogic	A complex object with information on how a data type is connected to a model. See ApplicationLogic.
taskId	A reference to a task from the application process. The value indicate that the data type requirements must be fulfilled before the process can move on from the given step in the process.
maxSize	The maximum allowed size of the data element.
maxCount	The maximum number of data elements of this type.
minCount	The minimum required number of elements of this type.
grouping	The name of a group. This can be used to logically associate a data type to a group. E.g Photos or a text resource key.
enableFileScan	A value indicating if the data type should be scanned for virus/malware. If a file is scanned and found to be infected before the process is complete, this will cause a validation error.
validationErrorOnPendingFileScan	A value indicating if a pending file scan should trigger a validation error and prevent the completion of the process before the scan is complete.

ApplicationLogic

ApplicationLogic holds information about how a data type representing a form is connected to a model.

Name	Description
autoCreate	A value indicating whether a data element will be automatically created once an instance moves into the process step indicated by taskId.
classRef	The name of the C# class used to represent the form as a model in application logic.
schemaRef	A reference to the original schema used to define the model.
disallowUserCreate	A value indicating whether the a user should be able to create an elemement of the data type. Defaults to allow it (false).
disallowUserDelete	A value indicating whether the a user should be able to delete an elemement of the data type. Defaults to allow it (false).

PartyTypesAllowed

PartyTypesAllowed contains a set of values indicating the type of owners an instance can have.

Name	Description
bankruptcyEstate	A value indicating that the instance owner can be a bancruptcy estate.
organisation	A value indicating that the instance owner can be any organisation.
person	A value indicating that the instance owner can be a person.
subUnit	A value indicating that the instance owner can be a sub unit.

PresentationField

PresentationField represents a form field extraction rule. Every time a form is being saved the presentation field rules will be applied and any values from the form will be stored directly on the instance. This can later be used to present instance specific data in places like the portal message box. The purpose is to make it easier to identify a specific instance in a list with many almost identical instances.

Name	Description
id	An id or key to identify the specific rule.
path	A path to a specific field or property in the form model.
dataTypeId	The name of the datatype. See DataType.

DataField

DataField represents a form field extraction rule. Every time a form is being saved the data field rules will be applied and any values from the form will be stored directly on the instance. While PresentationField will have logic applied to it with regards to where and how it’s used, the use of data fields is entirely up to the application developer and the application owner. One usage scenario is to provide data fields which can be used for routing to the correct backend system.

Name	Description
id	An id or key to identify the specific rule.
path	A path to a specific field or property in the form model.
dataTypeId	The name of the datatype. See DataType.

eFormidlingContract

This type is used by a feature still in development.

eFormidlingContract holds the configuration of the eFormidling integration for the application. An application configured to enable eFormidling integration in combination with the eFormidiling contract will send a shipment to eFormidling for every instance that is created.

Name	Description
serviceId	The service identifier of the process
process	The process type to be set on the shipment
receiver	The receiver of the eFormidling shipment.
sendAfterTaskId	The id of the last task to be completed before the shipment is sent
type	The document type of the shipment e.g. arkivmelding
typeVersion	The version of the document type
standard	The document standard e.g. urn:no:difi:arkivmelding:xsd::arkivmelding
securityLevel	The security level to be set on the standard business document
dataTypes	A list of the dataTypes to be included in the shipment. Data type for both form data and attachments should be listed to be included in the shipment

messageBoxConfig

MessageBoxConfig holds configurations related to the presentation of instances in the Altinn MessageBox.

Name	Description
hideSettings	The settings related to hiding an instance from the message box

hideSettings

Only one of the two settings should be used at a time.

Name	Description
hideAlways	A boolean indicating that the instance should always be hidden
hideOnTask	A list of tasks where the instance should be hidden from the message box

CopyInstanceSettings

Configure if copying data from an archived instance is allowed and what datatypes and datafields that should be excluded in the new instance

Name	Description
enabled	true/false if its possible to create a copy of an instance.
excludedDataTypes	List of DataTypes that should be excluded when a new copy is made.
excludedDataFields	List of fields in the DataModel that should be excluded when a new copy is made.

Meldingsboksen i portalen vil hvise en link med teksten Lag ny kopi hvis brukeren velger en arkivert instans.

OnEntry

Configure how the application behaves when a user opens the application without an instance id set

Name	Description
show	Possible values: new-instance or select-instance. new-instance : user will always get a new instance. select-instance : user will be presented with a list of active instances if any, if no active instances a new one will be created.

Complete example

This is a complete app metadata document with data types.

{
  "id": "ttd/bli-applikasjonseier",
  "versionId": null,
  "org": "ttd",
  "title": {
    "nb": "Bli applikasjonseier"
  },
  "validFrom": null,
  "validTo": null,
  "processId": null,
  "dataTypes": [
    {
      "id": "Kursdomene_BliTjenesteeier_M_2020-05-25_5703_34553_SERES",
      "description": null,
      "allowedContentTypes": ["application/xml"],
      "allowedContributers": null,
      "appLogic": {
        "autoCreate": true,
        "classRef": "Altinn.App.Models.BliTjenesteeier_M",
        "schemaRef": null
      },
      "taskId": "Task_1",
      "maxSize": null,
      "maxCount": 1,
      "minCount": 1,
      "grouping": null
    },
    {
      "id": "ref-data-as-pdf",
      "description": null,
      "allowedContentTypes": ["application/pdf"],
      "allowedContributers": null,
      "appLogic": null,
      "taskId": null,
      "maxSize": null,
      "maxCount": 0,
      "minCount": 0,
      "grouping": null
    },
    {
      "id": "uploaded-files",
      "allowedContentTypes": ["image/jpeg"],
      "taskId": "Task_1",
      "maxSize": 25,
      "maxCount": 1,
      "minCount": 5,
      "enablePdfCreation": false,
      "enableFileScan": true,
      "validationErrorOnPendingFileScan": true
    }
  ],
  "partyTypesAllowed": {
    "bankruptcyEstate": true,
    "organisation": true,
    "person": true,
    "subUnit": true
  },
  "messageBoxConfig": {
    "hideSettings": {
      "hideOnTask": ["Task_3"]
    }
  },
  "autoDeleteOnProcessEnd": false,
  "created": "2020-07-17T08:26:21.5707559Z",
  "createdBy": "sandgrainone",
  "lastChanged": "2020-07-17T08:26:21.5708691Z",
  "lastChangedBy": "sandgrainone"
}