Close popover

Table of Contents

Understanding offline data synchronization

Version:

When an offline-enabled mobile app is not connected to a network, an action queue stores local user actions. When network connectivity is restored, the contents of the action queue are pushed to the server, and Pega Platform processes them. At the same time, all modified data pages and work objects are synchronized to the mobile device.

When you design an application that users can access with an offline-enabled mobile app, consider the following information with regard to data synchronization.
Offline-enabled mobile apps support two types of synchronization:
Full synchronization
Sends all queued user actions to the server and synchronizes the application model and all data items and work objects to the mobile device. Full synchronization happens in the following situations:
  • When the user starts the offline-enabled mobile app for the first time, and you do not prepackage the access group data in the mobile app executable files.
  • When you force full synchronization for all users that belong to an access group.
  • When the user clears the local storage on a mobile device for debugging purposes.
Delta synchronization
Sends all queued user actions to the server and synchronizes only the changed data items and work objects to the mobile device. Delta synchronization can happen in the following situations:
  • When the user starts the offline-enabled mobile app for the first time, and you prepackage the access group data in the mobile app executable files.
  • Each next time the user logs in to the offline-enabled mobile app.
  • After a single user's action appears in the action queue, for example, when the user completes a transaction by submitting an assignment.
  • When the user taps the connection status indicator in the offline-enabled mobile app.
  • During a periodic syncing operation: every 5 minutes, if the server was last accessible, or every 1 minute, if the server was not accessible.
  • When the device goes from offline mode to online mode or a new hardware network interface is attached.
  • When you call a JavaScript API method that starts data synchronization.
When the mobile app initiates synchronization, the server determines if it is delta synchronization or full synchronization. You can synchronize mobile data even after you suspend or terminate an app. However, system settings and status, such as battery life or network connection, can limit or delay the synchronization process.

  • Data synchronization JavaScript API

    When you design an application that users can access with an offline-enabled mobile app on a mobile device, you can configure data synchronization frequency, data synchronization throttling, and the behavior of the synchronization indicator, by calling several JavaScript methods.

  • Offline case packaging optimization during synchronization

    When you design an application that users can access with an offline-enabled mobile app on a mobile device, you can improve the performance of an offline-enabled mobile app when the application contains a large number of case types. You do this by optimizing offline case packaging during synchronization.

  • Propagating application model changes to offline-enabled mobile apps

    When you modify rules in an existing application that users access with an offline-enabled mobile app, propagate the changes to mobile devices by forcing full synchronization for the access group to which the mobile users belong.

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.