Offline Mode is only supported on Safari for iOS and on Chrome for Android

What is Offline Mode?

The purpose of Offline Mode is to allow officers to continue to collect RIPA stop data while their mobile device is disconnected from a cell or other network connection and unable to access the Veritone Contact cloud-based service. Loss of network connection may happen when the officer is inside a building, remote location or other situations when cell networks are limited. While in Offline Mode, officers using the Contact application will be able to:

  • New Stop Reports can be started and the resulting report will be saved to the device

  • Stop Reports that were initiated prior to the device losing network connectivity can still be completed and the report will automatically be saved to the device

In both of these situations, completed reports will automatically synchronize to the Veritone Contact server once network connectivity is restored to the mobile device.

How do I set up Offline Mode?

To take advantage of the Offline Mode capabilities, the Contact application must be installed on the device (iOS or Android devices only). This app is not installable from the devices App Store. The installation process for Contact is as follows:

  • Android Devices: The first time the user browses to https://[agencyName].contact.us-gov-2.veritone.com, they will be prompted to “Install App.” If there is no prompt, there should be an “Install App” button within the Chrome menu options. If you don’t see the Install App button you are probably on an iOS device trying to install from a Chrome browser which is not supported.

  • In order to ensure Offline Mode works at least one Stop Report must first be completed while online.

  • iOS Devices (Safari browser only): The first time the user browses to https://[agencyName].contact.us-gov-2.veritone.com,

    • Tap the “Share” icon at the bottom of the screen, then , tap Add to Home Screen.

  • In order to ensure Offline Mode works at least one Stop Report must first be completed while online.

Both Android and iOS Devices: Once installed, Contact should function identically to the web app.Full support for Offline Mode requires it be installed as described above and a Stop Report. Otherwise,Offline Mode will not function properly.

Offline support also requires the cached data from the browser to be preserved. Clearing the browser cache (Safari on iOS, Chrome on Android, will render offline mode inoperable.

Offline support is made possible by leveraging Progressive Web Application technology. Unfortunately, PWA is not supported for Chrome on iOS.

How does Offline Mode work?

While the mobile device has an active network connection, the Contact application can synchronize itself with the Contact Server. This includes delivering completed reports from the mobile device as well as any updates that may be periodically required for the application itself.

When a device loses network connectivity, it is no longer able to access the Contact Server.

This means:

  • Draft Stop Reports started in online mode or that have been synced cannot be edited until network connectivity is restored.

Reviewer rejected Stop Reports cannot scene or corrected until network connectivity is restored.

  • Once any report is submitted and subsequently synced with the Contact Server, they will no longer be visible within the Contact mobile client until network connectivity is re-established.

  • Stop Reports that are open and in the process of being completed when connectivity is lost can still be completed or saved while in Offline Mode.

New Stop Reports can be created in Offline Mode using the Contact mobile application (installed as described above).

There is no real limit to the number of Stop Reports that can be created given how small the actual Stop Report data is when stored on the local device.

Stop Reports completed during Offline Mode will be stored on the local device.

  • This applies to Stop Reports created in Offline Mode and saved as drafts

  • This applies to Stop Reports created in Offline Mode and submitted/completed

  • This applies to Stop Reports that were in the process of being completed when connectivity was lost that are saved as drafts

  • This applies to Stop Reports that were in the process of being completed when connectivity was lost that are submitted/completed

Once connectivity has been reestablished, the Stop Reports created or saved while the device was disconnected, will be uploaded to the cloud automatically.

The Contact application will synchronize with the Contact Server and any other reports created by the officer may subsequently display in the mobile client once synchronization is completed..

How does Synchronization work

Offline Mode

  • Offline Mode is intended to allow an officer to continue to collect stop data even when they are disconnected from the internet.

    • It is intended for the collection of New Stop Data.

    • It is not intended as a mode for them to complete Stop Reports they have saved as Drafts and want to resume working on.

    • It is not intended as a mode to allow them to work on Stop Reports that have been returned to them by a Reviewer for rework.

Interrupted Work

  • If internet connectivity is lost while an officer is actively working on inputting Stop Data, they can continue to do so. The stop data will be saved on the device for later synchronization with the cloud.

    • This applies to Stop Data records started on the device while in online mode

    • This applies to Stop Data records opened from a cloud synced Draft on the device while in online mode

Syncing & Caching

  • When internet connectivity to the device has been re-established the device pushes Stop Reports save/completed in Offline Mode to the cloud.

  • A Stop Report created in Offline Mode, once synchronized, can be completed or edited from any other device, provided it has permission to view the Stop Report.

  • Once the status is shown as Synced, the form is now treated as a normal cloud based Stop Report.

  • Stop Reports synchronized with the cloud are not available to devices in Offline Mode until they reestablish a connection to the network.

    • I.E.

      1. An officer creates an offline Stop Report (ID-123)

      2. When they are reconnected to the internet

        • The Stop Report (ID-123) is synchronized with the cloud.

        • They can see other Stop Reports they created previously.

      3. If they go offline again they can no longer see other Stop Reports they created - INCLUDING the one they created offline and most recently synced: Stop Report (ID-123)

      4. When they are reconnected to the internet again

        • They can see other Stop Reports they created

        • INCLUDING the one they created offline and most recently synced: Stop Report (ID-123)

  • Stop Reports that are open on a mobile device when internet connectivity is lost can still be worked on in offline mode.

    • The fact that the Stop Report is open means it has synced back to the device. Thus it can be saved and completed and the data will be stored on the local device until internet connectivity is reestablished and the data can be synced to the cloud.

      1. This applies to New Stop Reports created and which are being worked on when internet connectivity is lost.

      2. This applies to Draft Stop Reports that are resumed and which are being worked on when internet connectivity is lost.

      3. This applies to Rejected Stop Reports that are being worked on when internet connectivity is lost.

    • This does not Lock the Stop Data report to the device.

      1. There is no concept of “exclusive” access to Stop Reports

Statuses

  • On the Mobile Device Statuses are displayed between the Date and the Status of the report record on mobile devices.

  • Statuses for Stop Reports created in offline mode are as follows

    • Offline

    • Synced

  • In addition to seeing the Stop records collected offline syncing from the device when connectivity is reestablished, the user can go to the desktop app to view the syncing status of the reports they created in Offline Mode.

    • The Online/Offline toggle needs to be set to Offline Mode

    • The syncing status is displayed under the Status column on the Officer’s Desktop Dashboard

How do I report bugs?

Provide Device Info

  • E.g.

    • iPhone 12 Pro Max.

    • Software Version: 14.7.1

Provide Browser Settings

  • E.g. Safari Settings

    • Block Pop-ups is On

    • Prevent Cross-Site Tracking is On

    • Block All Cookies is Off

    • Advanced / JavaScript is On

Indicate if the PWA app is being used (that is, the Contact app saved to the Home Screen)

  • Provide steps to reproduce the bug

  • Provide screenshots

  • Provide Org name

  • Provide as detailed a description of the issue as possible

How To Test Offline Mode

Starting A New Report: Offline Test

  1. Login to the Contact app

  2. Disable WiFi and Cellular service on the mobile device

    1. You should see a toast (a notice that pops up from the bottom of the screen) indicating that the app is in Offline Mode.

  3. Complete a Stop Report

    1. Put a description in the location field to identify this order as one you created offline instead of supplying an address. I.e. Offline Safari Test 9-16-2021 12:40 PM. This will make it easier to identify the Stop Report on the officer dashboard.

  4. Submit the Stop Report

    1. You should be returned to the officer dashboard.

    2. The offline Stop Report should be visible at the top of the list.

  5. Reconnect to your cellular or wireless service

  6. Click the login button from the Contact app drop down

  7. The offline form should be automatically synced with the cloud.

Interrupted Connection During a Report: Offline Test

  1. Login to the Contact app

  2. Begin a Stop Report

    1. Put a description in the location field to identify this order as one you created offline instead of supplying an address. I.e. Offline Safari Test 9-16-2021 12:40 PM. This will make it easier to identify the Stop Report on the officer dashboard.

  3. Disable WiFi and Cellular service on the mobile device

    1. don’t go to the officer dashboard first or save the draft that will cause the draft to be synced

    2. You should see a toast indicating that the app is in Offline Mode.

  4. Resume completing the Stop Report offline

  5. Submit the Stop Report

    1. You should be returned to the officer dashboard. The offline Stop Report should be visible at the top of the list.

  6. Reconnect to your cellular or wireless service

  7. Click the login button from the Contact app drop down

  8. The offline form should be automatically synced with the cloud

For additional questions surrounding Offline Mode setup, please contact Veritone Support at [email protected]

Did this answer your question?