Altinn Apps integration

Reference information for Altinn Apps integration

Application metadata

These settings, along with other, can be defined in the file App/config/applicationmetadata.json

Sync adapter settings

Set any of the properties below under syncAdapterSettings to true to override the automatic synchronization:

Enable user-supplied dialogId

By default, the adapter generates a dialog ID deterministically from the instance ID and creation timestamp of the instance. Enabling this setting instead uses a dialog ID supplied by the app itself, found in DataValues entry with key dialog.id.

Requirements for the supplied dialog ID:

• Must be a valid UUIDv7
• The timestamp embedded in the UUID must be in the past
• Must not already be in use by a different app instance

Collision detection: The adapter checks the given dialog for any service owner labels with urn:altinn:integration:storage:{instanceId}. If a label is found pointing to a different instance, the sync is rejected

Example

This shows the default syncAdapterSettings. Set any to true to override. Changes will not have retroactive effect on any dialog before a resync, which happens whenever the instance is updated or instance events are added.

{
  "id": "ttd/my-app",
  /* ... */
  "messageBoxConfig": {
    /* ... */
    "syncAdapterSettings": {
        "disableSync": false,
        "disableCreate": false,
        "disableDelete": false,
        "disableAddActivities": false,
        "disableAddTransmissions": false,
        "disableSyncDueAt": false,
        "disableSyncStatus": false,
        "disableSyncContentTitle": false,
        "disableSyncContentSummary": false,
        "disableSyncContentAdditionalInformation": false,
        "disableSyncContentExtendedStatus": false,
        "disableSyncAttachments": false,
        "disableSyncApiActions": false,
        "disableSyncGuiActions": false,
        "disableMarkCompletedWhenConfirmed": false,
        "enableUserSuppliedDialogId": false
    }
  }
}