Skip to main content

Foreground and Background Scenarios

The following tabular describes how the application behaves in both foreground and background scenarios.

Low or No Internet Connection
Foreground
When the mobile app detects a low or no internet connection while the application is open, a popup appears prompting the user switch to Offline Mode.
Background
A notification is sent to inform the user that the internet connection is unavailable. Tapping the notification redirects to the app, where a popup appears prompting the user to switch to Offline Mode.
Manual Switch to Offline Mode
Foreground
Users can manually switch to Offline Mode at any time, by navigating to :
  • The application enters offline mode immediately and records will be available based on the assigned briefcase configuration.
  • The count of how many records have been downloaded so far will be available in the Offline Home page
Background
Not applicable; manual switching is not available while the app runs in the background.
Manual Switch to Online Mode (Only if the internet connectivity is available)
Foreground

The user can navigate to:

manually switch or can redirect from the Home Page.

On confirmation, the user is redirected to the Logs Queue page (if logs are present), and the offline to online data sync will start.

Background
Not applicable for manual switching.
Internet Connection is Restored – Transition to Online Mode
Foreground
When the application is running in foreground and the internet connection is restored, a popup appears asking the user to switch to Online Mode.
Background
A push notification informs the user that internet connectivity is restored, when the app is running in the Background. Tapping it redirects to the application, where the popup appears asking the user to switch to Online Mode.
During Offline to Online Data Sync
Foreground

The user stays on the Logs Queue page during sync. This page will be static until the sync happens completely.

Sync progress is shown for each log entry.

The user cannot perform other actions until sync is complete.

Background
Push notifications are sent when logs finish syncing. Tapping the notification redirects to the Logs Queue page.
Conflicts and Errors During Sync
Conflict
If a record was actioned in Offline and it was also modified online, it creates a conflict.
Error
Error happens due to any interruption to the internet connectivity.
Foreground

An indication of which log is conflicted or errored will be shown in the logs syncing screen.

The user must either delete those changes or retry syncing.

Background
When the sync gets conflicted or errored, relevant notifications will be sent.
After Successful Synchronization
Foreground
A confirmation notification appears once all updates are synced.
Background
SLAs, escalations, and notifications resume automatically in the background. Temporary offline data is cleared after all sync operations finish.