Auto Sync Setup

Prerequisites

Basics

  • Setting up Auto Sync enables the automation of upload syncs from FieldFX Mobile to FieldFX Back Office.

    Downloading from FieldFX Back Office to FieldFX Mobile already occurs automatically at specified intervals.

  • Admins can troubleshoot sync packet issues with the Admin Portal’s Sync Event Viewer tool for the upload portion of Auto Sync.

  • Admins can resolve Sync Upload Errors with the Packet Viewer in the Audit Log.

Considerations

  • The org must enable attachments through the Files API, as Auto Sync relies on the Files API for the automatic syncing of data.

    Auto Sync does not use or support either Chatter or Notes & Attachments lists. All reports and files that sync do so through the Files API.

  • Field users must have an active and available Internet connection for data to sync. Offline data automatically syncs when an Internet connection becomes available.

How It Works

  1. When a FieldFX Mobile user makes a change, the field device automatically initiates the sync process as soon as the change is complete.

    FieldFX Mobile waits three seconds after a user completes one change in case they also make another change.

    If a field user does not have an available Internet connection, the changes are stored until a connection becomes available. Queued changes automatically upload when a connection is reestablished.

  2. Events in the sync load to the FX5__Sync_Events__c object from the mobile device.

  3. Apex code runs to process the events, marking successfully synced events for deletion.

    The code processes the events according to the size of each event:

    1. For events under the batch size, events are processed synchronously.

    2. For events over the batch size, events are processed asynchronously using the batching API from Salesforce.

  4. A nightly process removes events marked for deletion.

    The FX5__SyncEventKeptHistoryInDays__c custom setting controls how long to keep events marked for deletion. The default is 40 days.

  5. Review failed events in the Sync Events Viewer in the Admin Portal (admin.fieldfx.com).

Setting Up the Auto Sync Feature

  1. Enable attachments through the Files API, as Auto Sync relies on the Files API for the automatic syncing of data.

    Auto Sync does not use or support either Chatter or Notes & Attachments lists. All reports and files that sync do so through the Files API.

  2. Configure page layouts and train FieldFX Back Office users in how to work with attachments using the Files API.

  3. In FX Settings, create a Checkbox (Boolean) custom setting:

    1. From Setup, enter Custom Settings in the Quick Find box, then click Custom Settings

    2. Click FX Settings

    3. Click New next to Custom Fields

    4. Select Checkbox, then click Next

    5. Make the following entries:

      • Field Label: EnableAutoSync

      • Default Value: Checked

      • Field Name: EnableAutoSync

        This defaults in if you entered the Field Label as above.

        This must be entered exactly as listed.

      • Description (optional): Enables automatic sync upload from FieldFX Mobile to FieldFX Back Office

    6. Click Next, then click Save

  4. Verify that the Sync Packet Size field in FX Settings is set to 60.

    1. From Setup, enter Custom Settings in the Quick Find box, then click Custom Settings

    2. Click FX Settings

    3. Click Manage

    4. Scroll down to the Sync Packet Size field and verify the value

    5. If necessary, click Edit, update the Sync Packet Size value, then click Save

  5. Add the Sync Events Permissions Permission Set to all Field Users and Admins

    As an alternative, add the SyncEventPermissions permission set to the Permission Set Groups you use for Field Users and System Administrators.

    1. From Setup, enter Permission Sets in the Quick Find box, then click Permission Sets

    2. Click the S to filter the list of permission sets to those that begin with the letter S, then click SyncEventPermissions

    3. Click Manage Assignments

    4. Click Add Assignments

    5. Select the checkbox next to each Field User and Admin, then click Assign

    6. Click Done when all users have been assigned

Recommended Reading