Version

Understanding Synchronization

The Synchronization process is activated when there are lists with offline support enabled and the device is idle for a fixed number of seconds. The frequency in which the process is triggered can be modified through an advanced configuration setting (SyncIdleTime). Alternatively, you can trigger the process yourself using the Sync Now feature.

The Synchronization Process

This process runs in the background while SharePlus is active and the device is online. SharePlus requests a block of list items to the SharePoint server to store them locally. After storing the block of items, if SharePlus remains idle the process continues to synchronize the rest of the list items. The frequency in which the synchronization process is triggered can be specified in the Configuration File (SyncIdleTime setting), or directly in the device through the UI (Idle time).

When SharePlus is moved to the background (the app state changes and is no longer active), the synchronization process is triggered. The process runs for about 7 minutes and then stops due to platform limitations.

Note

Note: the sync process is suspended when:

  • The user interacts with the device (in order to free bandwidth for navigation).

  • SharePlus is sent to the background.

  • The device is suspended.

Automatic Sync

Open Synchronization from the SideBar to start and also monitor the synchronization process.

AutomaticSync_iOS

Once the process is finished, all the list contents will be cached locally.

Sync Now

You can trigger the synchronization for a list for both sync modes, Per Item or View Based.

  1. Tap & hold over a list to access its Actions.

  2. Then, choose Sync Now to start the sync process.

SyncNow_iOS

Synchronization status icons

Once the process is triggered, the list will go through the synchronization process.

Synchronizing_iOS

Once the process is successfully completed, the list is synchronized and the sync status icon turns green.

SynchronizationComplete_iOS

The sync status icons are used to illustrate different states when having Offline Support enabled.

  • Grey icon - A list or item is not yet synchronized.

  • Red icon - A list is being synchronized or has pending changes.

  • Green icon - A list or item is fully synchronized with the SharePoint server.

AllSyncIcons_iOS
Note

Note: A document bigger in size than the Max Document Size setting (15 Mb by default) won’t be synchronized. As a consequence, the sync status icon will remain in color red to notify the document’s status.