Using APNS mode for auto sync
You can set HCL Traveler for Apple devices to use APNS (Apple Push Notification Service) mode for auto sync for the To Dos and Verse apps.
Based on the device configuration, APNS messages can cause the device to change the app badge count, show an alert, and so on. For the Verse app, APNS messages can also cause the app to sync in the background.
APNS messages may contain the standard APNS fields of a badge count, sound and body. These fields
are device controlled, even if the user cannot pick them all individually. For the badge
count, it will vary per app. For the Verse app, this is the number of unread documents
in the Inbox within the specified sync period; for the To Dos app, the badge count
indicates how many types of changes (adds, updates, or deletes) are pending to be synced
and not the number of items that need to be synced. By default, the body contains
information on the originator or sender of the information; for mail and notices, this
is the person who sent the mail or meeting notice. Optionally, the body may contain
additional summary information, such as the subject. The content of the body is
controlled by the administrator using the
NTS_PUSH_ALERTS_ALLOW_SENDER
,
NTS_PUSH_ALERTS_ALLOW_SUMMARY
, and
NTS_PUSH_ALERTS_ALLOW_ABSTRACT
settings. See the
notes.ini
settings documentation for further information. Note: The To Dos app does not support
background sync. It will only sync when opened or as a result of a manual
sync.
For the Verse app messages, they may also contain some custom APNS fields. These fields are
hidden from the user.
- TIMESTAMP
- The time that the server sent the message. Number of milliseconds since January 1, 1970 (epoch time).
- UNID
- Domino UNID of the document to which this alert refers.
- LGUID
- Sync ID of the document to which this alert refers.
- FLAGS
- Change flags, indicating which applications need to sync. APNS messages only contain applications that need to be synced or security operations that need to be performed. There are no user names or contents (mail, calendar, contacts, journal or ToDos) contained in the message. APNS messages only trigger the device to perform a sync for the given applications or take the appropriate security actions, at which point the device receives the relevant sensitive information, such as user names and data contents.
Traveler utilizes HTTP/2 for communication with Apple's APNS servers. APNS is enabled on the server by default, but it can be configured as needed using the settings described in Notes.ini settings and Push messaging through a proxy.