Notifications

Notifications

The STP.Documents On-premise Agent can send notifications about newly received tasks to the STP.Documents.OnPremise Mobile DESK. Users then receive a push notification on their smartphone or desktop system. Since these notifications cannot be transmitted through the end-to-end encrypted channel of the STP.Documents On-premise Agent, they must be explicitly enabled in the configuration. The configuration for the STP.Documents On-premise Agent is located in the appsettings.json file in the program directory (C:Files (x86)AGDocuments OnPremise Agent). After modifying the file, the STP.Documents On-premise Agent must be restarted.

In the configuration, you can specify the interval in seconds at which the DMS should be checked for new tasks. You can also specify the user IDs of the users who should receive notifications. The more IDs you enter here, the larger the interval should be to avoid overloading the DMS server. If you want the task texts to be included in the notifications, this can also be enabled. Please note that task texts may contain sensitive data, which would be transmitted in plain text to the cloud if this setting is enabled.

{
    ...
    "TaskObserver": {
        "PollIntervalInSeconds": 300,
        "DmsUserIds": [ 10000441384 ],
        "IncludeTaskTextInEvent": true
    },
    ...
}

A new permission is required to set up push notifications on the smartphone. The user group Documents2.NotificationCredentialsUsers grants permission to set up notifications and can be assigned in the cloud user management.

A new section will then appear in the Mobile DESK settings. Here, the current browser can be registered for notifications. The smartphone will ask for permission. For each registered browser, you can specify for which events a notification should be triggered. Click Save to activate the changes. For every new task, this browser will now receive a push notification.

To receive push notifications on the iPhone, Mobile DESK must be pinned to the home screen. In addition, Notifications and Push API must be enabled in the advanced Safari settings. This should be the case from iOS 16.4 or Safari 16 for macOS 13 onwards.

Notifications can also be disabled at any time by either deactivating the event or removing the browser from the list.