Configuring AppSuite synchronization
With the right configuration, any issues that may occur during the synchronization between the AppSuite app (field engineers) and Planon ProCenter (the back-office) can be monitored and processed in the Background actions TSI.
Synchronization between the devices using Planon AppSuite and Planon ProCenter takes place as a background action. All transactions on the app that need to be sent to the back-office are channeled via the app's outbox on the mobile device to the AppSuite inbox in Background actions. If synchronization fails for some of these actions, these will be listed as completed with errors and they can be queued for a retry.
• Application managers can 'repair' failing background actions by updating / correcting relevant data in the back-office (Planon ProCenter).
• If an AppSuite background action with errors cannot be resolved by the above method, please contact Planon Support. They can fix failing background actions by changing the content of the message received from the device. In addition, they will investigate the problem and create a ticket if a software fix is required.
Examples of synchronization problems are:
• Authorization issues: field engineers may not have the correct access rights.
• Validation issues: mandatory fields that are not populated.
• Configuration issues: status transitions were incorrectly configured.
 | For more information on monitoring and solving issues via Background actions, see the > user documentation. |
For the process to work properly, configure the following:
• In the Background actions TSI, add the AppSuite inbox selection step (system name AppMan_Nova_BackgroundAction).
• In the Scheduled tasks TSI, configure and activate the SYSNOVA_PMFS_CHECKER scheduled task. The AppSuite inbox requires this scheduled task to check failing background actions and retry them. Failing background actions will automatically be picked up. Processing and retrying takes place as follows:
◦ Background actions related to the same order are synchronized in sequence. The scheduled task will pick up the background actions of a single order one by one. Depending on your Schedule settings, the scheduled task will run every 'x' minutes, so it may take some time to process all background actions of a single order. The default setting is every 5 minutes.
◦ Background actions of different orders are processed in parallel.
• In the Scheduled tasks TSI, the SYSBACKGROUND_ACTION_CLEANER scheduled task, automatically removes inbox messages older than 7 days.
 | The > replaces the Planon Error gadget and the AppSuite logs TSI. |