Syncing Data

Prerequisites

Basics

The act of synchronizing data between FieldFX Mobile and FieldFX Back Office is a called "sync".

You must sync data regularly in FieldFX Mobile to stay up-to-date.

There are three types of sync:

Type Duration Occurs Downloads Uploads

Full

Longer
Downloads every record and syncable attachment you have access to

After you:

  • Log in

  • Clear the browser cache

  • Accessible records

  • Syncable attachments

-

Incremental

Shorter
Only download and upload changes made since the last sync

When you select Sync

  • New records

  • Record updates

  • New attachments

  • New records

  • Record updates

  • New attachments

Upload [1]

A few seconds
Only upload changes made since the last sync

When you select Upload Only

-

  • New records

  • Record updates

  • New attachments

Sync Rules

Sync rules control when records and attachments sync:

Pre-Sync Check

A pre-sync check runs every time you sync.

  • If you pass the check, the sync runs as normal.

  • If you fail the check, the sync fails instantly and a message displays what you are missing.

This check determines whether you have the following:

  • FieldFX Base Package license

  • FX E-Ticketing license

  • Contact linked to your user record

  • Read, Create, and Edit permission for the Audit Log object

  • Read and Edit permission for every managed field on the Audit Log object

  • Permission to use the FX5.Field Ticketing app

  • Permission to execute the following Apex classes:

    • FX5.FieldSetSvc

    • FX5.GetUtilityUserInfo

    • FX5.SObjectChecksum

Best Practices

  • Sync data at least once a day

  • Don’t sync repeatedly as there is a limit to the amount of data you can sync in a 24-hour period.

    Refer to the API Limits article for further details

  • Wait for a sync to finish before you log out, close FieldFX Mobile, or go offline

    If you don’t wait for a sync to finish, you won’t be able to use FieldFX Mobile until you finish the sync.

  • If you encounter a problem during a sync:

    • Contact your system administrator immediately

    • Don’t sync again

    • Don’t log out, close FieldFX Mobile, or close the FieldFX Mobile

    • Don’t open FieldFX Mobile in another tab or browser window

    • Don’t clear the browser’s cache

    • Don’t uninstall and reinstall the shortcut for FieldFX Mobile

    • Don’t switch off your device

Videos

Syncing Best Practices

Syncing Data

Step-by-Step Guides

Syncing Pending Changes and Downloading Updates

Complete the following to sync changes you made since the last sync and download updates from xref/FieldFX-Back-Office.adoc[FieldFX Back Office].

  1. Connect to the internet

  2. Select FX

    FX Mobile’s FX button

  3. Select Sync

    The Sync button turns into a progress bar.

    FX Mobile’s sync in progress bar

    Select the Down arrow in the Sync Details section to view diagnostics.

    Use the diagnostics to see how many records are downloading from FieldFX Back Office and to see how your sync is progressing.

    FX Mobile’s sync details panel with progress bars

Syncing Pending Changes Only

Prerequisite

Available on the Sync 4.0 release channels only.

Complete the following to sync changes you made since the last sync, without downloading anything from FieldFX Back Office.

  1. Connect to the internet

  2. Select FX

    FX Mobile’s FX button

  3. Review Pending Changes

    The Pending Changes list displays changes you made on the device since the last sync.
    FX Mobile’s pending changes section

  4. Select Upload Only

    FX Mobile’s Upload Only button
1. Available on the Sync 4.0 release channels only