How Offline Mobile Works

Introduction

Offline mobile empowers users to collect and submit data using offline forms, even when they don't have an internet connection. These forms offer robust functionality such as cascading dropdowns, wizards, validations, and conditional content.

To make this capability possible, Appian uses an offline evaluator, which processes and reevaluates interfaces locally on the device, eliminating the need for a server connection.

This page covers:

• The building blocks of offline forms.
• How offline mobile works with data.
• How users work with offline-enabled interfaces.
• Diagram of the offline mobile process.

The building blocks of offline forms

Users get their work done offline using offline forms, which are offline-enabled interfaces set up as site actions or tasks. Tasks can be displayed offline using a custom task report or mobile site task list.

These are the only interfaces that the offline evaluator can evaluate.

Offline-enabled interfaces

All offline functionality starts with an offline-enabled interface, which is an interface object that is enabled for offline use. When you design offline-enabled interfaces, you must follow the Offline Mobile Design Best Practices to make sure your interfaces can be evaluated by the offline evaluator.

You will use these interfaces in site actions, tasks, and custom task reports. You can also display them as read-only interfaces on a site by adding them as an Interface type site page.

Site actions

An offline site action is an offline-enabled interface configured as an Action-type page in a site. Action pages display a start form for a process model that allows users to initiate a process after filling out a form.

In Appian Mobile, users can navigate to the site page and fill out the form whether they are offline or not.

After they complete the form and go online, the form is submitted and starts the associated process.

Tasks

An offline task is an offline-enabled interface configured as a user input task in a process model.

In Appian Mobile, users can open and fill out tasks that are assigned to them whether they are offline or not. If the task is assigned to a group, they must accept the task before going offline.

After they complete the task and go online, the task is submitted and the associated process continues.

Task lists

Users can access tasks from task lists. There are two types of task lists: custom task reports and mobile site task lists.

Custom task report

An offline custom task report is an offline-enabled interface that uses process task links to display task information on a site page. Many times these interfaces use a!queryProcessAnalytics() to query a process report object of type Task.

In Appian Mobile, users can access offline tasks in the custom task report whether they are offline or not.

For help creating a custom task report that follows the offline mobile best practices, see the Offline Mobile Task Report recipe.

Mobile site task list

The mobile site task list is a configuration in a site object that allows you to enable a task list for the site in Appian Mobile.

When enabled, after a user selects the site, the Appian Mobile menu displays the Tasks list. This list displays all tasks assigned to the user.

In Appian Mobile, users can access offline tasks from this list whether they are offline or not.

How offline mobile works with data

Generally, when the user accesses an interface, it just pulls the data needed from the server in order to display. However, when a user is offline, interfaces can't communicate with the server to get this information.

In order to create a consistent user experience, offline-enabled interfaces work the same on Appian Mobile whether the user is offline or online. When you enable an interface for offline use, you are changing the way that the interface communicates with the server. Instead of being able to talk to the server whenever it wants, it only talks to the server when an interface is first loaded and caches the data on the device. After that, it assumes the server isn't there, even if the user is online.

When an offline form is submitted, it always goes to the Pending Forms list in the Appian Mobile menu . If the device is online when the form is submitted, it is sent from Pending Forms to the server right away. If the device is offline, it remains in Pending Forms until the device goes back online. Once online, the form submits automatically.

Syncing data for offline use

While online, users can sync their offline forms to make sure they are using the most up-to-date interfaces, processes, and data. Users will need to remain online long enough for the data to sync successfully. The amount of time required will depend on the strength of the device connectivity and the amount of data being synced.

Triggering an offline data sync

The best way to sync data is by triggering an offline data sync from the mobile menu. This will sync all offline interfaces, processes, and data.

To trigger an offline data sync:

1. In Appian Mobile, open the mobile menu.
2. Tap Data Sync.
3. Tap START SYNC.
4. Remain online until the sync completes.

Other methods to sync data

Before going offline, we recommend that users trigger an offline data sync to ensure everything syncs successfully and they can work disconnected with confidence.

However, data is also synced in the following ways:

• Receiving a push notification for a new task. Receiving a push for a new task while online triggers a sync for all offline tasks.
• Syncing automatically in the background. Every 2 hours, a background fetch will attempt to sync the data for all offline forms. This fetch is dependent on the operating system's prioritization of background processes and is not guaranteed. Additionally, to be successful, when the fetch occurs:
  • The user must be online.
  • Appian Mobile must be running in the background, not force closed.
• Signing in to Appian Mobile. Any time a user signs in to their account, the data for all offline forms will sync.
• Loading the mobile site task list or the Tasks or Actions Tempo pages. When the user navigates to one of the following locations in Appian Mobile while they are online, the data for offline tasks or actions will sync.
  • Opening the mobile site task list will sync all offline tasks.
  • Opening the Tasks page in Tempo will sync all offline tasks.
  • Opening the Actions page in Tempo will sync all offline actions.
• Pulling to refresh. Offline data on an action or mobile site task list will sync any time the user is online and pulls to refresh the page. If you are using a custom task list, we highly recommend triggering an offline data sync instead of relying on the pull to refresh behavior to ensure everything syncs successfully.

How users work with offline forms

To ensure users are getting the most up-to-date data, they should be coached about how to use offline forms.

The most important steps that users should be aware of are:

1. Make sure the Appian Mobile application is up to date.

   Note:  For offline mobile capabilities to work, the Appian Mobile application on the user's device must be the same version or newer than the Appian environment.

2. When online, trigger an offline data sync to download the latest interfaces, processes, and data to the device. Remain online until the sync completes.
3. Complete and submit offline forms as normal, whether offline or online.

   • If the user is offline when they submit the form, it will queue the form for submission. The user can access the form in the navigation menu under Pending Forms. After they go back online, the form is submitted automatically.

     

   • If they are online when they submit the form, the form submits right away.

     Tip:  Sometimes when a pending form fails to submit, a retry icon displays on the Pending Forms list. The user can tap the icon to retry the form submission.

     

Diagram of the offline mobile process

The following diagram shows how offline forms are evaluated.

Step	Description
Initial evaluation on the server	During an offline data sync, the data queries and partially compatible functions that are loaded in local variables at the top of the parent interface are downloaded and cached onto the mobile device.
User input	Whether the user is offline or online, they enter information into the form using the mobile device.
Offline reevaluation	The data on the interface reevaluates based on the user input. The user does not need to be online for this reevaluation to occur. Only Compatible and Partially Compatible functions in the Appian functions table are supported in offline mobile. If you need to use Partially Compatible functions, you will need to load them in a local variable at the top of the interface.
User input stored	The user input is stored on the device. If the user is offline, the form goes into a pending state.
Form submitted	When the user has an online connection, the form is submitted. The server replays all user interactions to ensure consistency, then moves to the next node in the process model, such as the write records smart service.

Feedback