Reconcile or Send/Receive

 

About

"Reconciling" performs a send/receive from the mobile app to the ProntoForms server. 

  • This syncs new form versions, data sources, and dispatches from the web portal to the mobile app, to ensure that mobile users are working with up-to-date resources.
  • This also syncs new form submissions from the mobile app to the web portal, to ensure that work completed by a mobile user gets properly submitted and sent through data destinations

 A network connection is required in order for a reconcile or send/receive to be successfully completed.

 

How Do I Manually Reconcile?

reconcile_or_send_receive.png

The Reconcile button can be found:

  • At the bottom left of the Home screen on iOS devices
  • At the top right of the screen on Android (Prontoforms 6.8) devices.
  • On the top or bottom right of the home screen on Windows 10 devices.

The device platforms that ProntoForms runs on limit any apps' ability to sync while the app is in the background (not on-screen). Ensure that the ProntoForms app remains in the foreground when performing a reconcile so that it is not interrupted.

  • Do not close the app before the Reconcile is complete.
  • Do not switch to other apps or screens before the Reconcile is complete.


Note: On some platforms, the app may continue to reconcile for a few moments once the app is off-screen, but each OS has a limit on how long this may happen.

Note that the larger the form (take photos, etc into consideration) the longer it will take to reconcile, although this is still usually complete within a few seconds. Please make sure that you have a good network connection when you are reconciling your device.

[ top ]

 

When does the mobile app automatically reconcile?

In order to preserve the battery life of your mobile device and minimize unnecessary usage of cellular data, the mobile apps do not constantly sync to the web portal.   However, several things can trigger a reconcile to ensure that users have the most up to date resources possible when working online.

Keep in mind that a reconcile can only be initiated and completed when:

  • A user is working online, and the ProntoForms mobile app has access to either wifi or cellular data
  • The ProntoForms mobile app is open and on-screen

The device platforms that ProntoForms runs on limit any apps' ability to sync while the app is in the background (not on-screen). Ensure that the ProntoForms app remains in the foreground when performing a reconcile so that it is not interrupted.

 

User actions that trigger an automatic reconcile:

Some user actions lead to the mobile app initiating a reconcile.

  • Opening the mobile app when it has not been reconciled in over an hour: When launching the ProntoForms app, if it detects that it has not been reconciled in over a hour, it will attempt to reconcile if the device is online.  This helps ensure that users working online are not using resources that are more than an hour out of date.  (Note:  This is supported on Android and iOS only.  Not supported on Windows 10.)

  • Submitting a form:  When a mobile user submits a form and is working online, the app will automatically try to reconcile.  If it is successful, the form will reach the ProntoForms server.  If not, it will remain in the device's outbox until the next reconcile is triggered.  This helps ensure that submitted forms make it to the web portal as soon as possible, and to sync any new updates from the web portal (new forms, etc) at the same time.

 

Web portal actions that trigger a reconcile through a push notification:

Some actions performed in the web portal cause a push notification to be sent to the mobile apps.  Push notifications are only received while a user is working online.

Note: Push notifications are not supported on Windows 10.  

 

Automatic reconcile after a push notification:

  • If a user has the mobile app open and is on a List screen (Forms, Inbox, Drafts, Sent) when they receive a push notification, the mobile app will automatically reconcile with no user intervention.   

 

User-triggered reconcile after a push notification:

  • When a user taps on a push notification, the mobile app will open and reconcile.  This is true regardless of what they are currently doing on their mobile device (i.e. on their device home screen, in another app, reading their email).

 

When does the mobile app NOT automatically reconcile?

  • While working offline
  • While a user is currently working on a submission that is on-screen in the mobile app
  • When the app is in the background (not on-screen):   This means that if a user was working offline and created a number of form submissions that are in their outbox, they will need to manually re-open the ProntoForms app and reconcile once they are back online, in order for these to sync to the web portal.

[ top ]

 

 

What if I Need to Work Offline?

The ProntoForms mobile app is designed to work offline.  Users can to fill out and submit forms when their device does not have a network connection.  No data will be lost.  Submitted forms can be sent in by reconciling once a network connection is available.

However, the device does still need to be reconciled periodically, especially in order for submitted forms to be sent to the server. Otherwise, submitted forms will be stored locally (only on the device) in the app's Outbox.

If workers are frequently in areas with no network connection, administrators should plan accordingly, and not expect field users to have new data the moment they make changes to a form or data.  If an update to a form/data source has been made that is absolutely essential for users to have, it may be advisable for administrators to send out a communication to all users reminding them to find the time to reconcile before beginning work on their forms.

[ top ]

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

  • Avatar
    Donald Brahs

    Is there an option for the application to automatically reconcile when it is launched?