Sync Wizard

Introduction

You can use the Sync Wizard to create Sync Profiles to assign to field users. Sync Profiles determine the objects and fields that sync to assigned users' mobile devices. The profiles created in the Sync Wizard can manage what syncs for multiple users, similar to how User Profiles manage permissions to objects and fields.

Prerequisites

To setup and use the Sync Wizard Admin Portal Tool, you need to:

Have these user licenses Have these permissions for System Administrators Complete these tasks
and review these topics
before continuing
  • System Administrator permissions for Salesforce

How it Works

  • Create a Sync Profile using the Sync Wizard tool.

  • Assign a Sync Profile to field users.

    You need to add the Mobile Sync Profile field to the User object’s page layout first.

  • The sync packet that downloads to FieldFX Mobile only includes the objects, fields, and attachments for syncable records specified in the user’s assigned Sync Profile.

    Whether an individual record is syncable is determined by other factors, not by the sync profile.

    Those factors include:

  • Keep in mind:

    • Permission sets and Profiles grant access for users to access any data in objects and fields. With no permission at this level, no data from the object or field is available to the user anywhere.

    • Sharing rules determine whether users have any access to a particular record in either FieldFX Back Office or FieldFX Mobile.

    • Sync and AltSync rules determine whether a particular record should be available on mobile devices for any user.

    • Sync Configuration records determine whether a particular user needs access to a record on their mobile device based on criteria specific to that user.

  • When all four of the above are true, the Sync Profile determines what subset of objects, fields, and attachments should download to the user’s mobile devices.

Step by Step

Create the Default Sync Profile

  1. Go to admin.fieldfx.com and log in to the desired production or sandbox org.

  2. Select Sync Wizard.

  3. Select Start Wizard.

    The first time you use the Sync Wizard, you must first create a Default Sync Profile.

    After creating the Default Sync Profile, you can create additional profiles and are prompted to customize the profile’s name.

  4. Select Let’s Get Started.

  5. In Sync Mode, select the types of devices for this group of users, then click Next.

    • Dedicated Mode: Users each have their own device that is not shared by other users.

      FieldFX recommends dedicated devices for field users.
    • Shared Mode: A device may be used by multiple users, such as between shifts.

      image

  6. Select the type(s) of records (objects) users either add or modify on their devices, then click Next.

    Be sure to only select the type(s) the set of users for this Profile add or modify on their devices.

    If they only view the records, do not select the checkbox.

    For example, field technicians do not add or modify quotes while sales people likely do not add or modify tickets or work orders.

    image

  7. Select whether members of Job Crews should only sync the crew’s jobs and related price books, then click Next.

  8. In Synced Objects, review the objects the wizard determined should sync for these users and make any desired adjustments by selecting or deselecting objects.

    Data from objects that are not selected do not sync to mobile devices for users assigned to this Sync Profile.

    The selected options do not change any user’s permissions to the object or access to individual records or fields in the object.

    Users must also have permission to the object from their User Profile or at least one Permission Set for data from the object to sync!

    To display each object’s API name, select the Show Details checkbox.

  9. After making the selections for Synced Objects, the Sync Wizard runs a query to search for required fields, then presents a series of screens to determine what fields to sync for specific objects.

    Master data objects display first, then transactional objects.

    To see the API names for fields, select the Show Details checkbox.

    Recommended fields are pre-selected, but can be removed if not needed on mobile devices.

    Fields required for syncing display in a separate group at the bottom of the page and cannot be deselected.

    The selected options do not change any user’s permissions to fields on the object. Users must have permissions to the selected fields from a User Profile or at least one Permission Set to sync data for the field.

  10. Make any desired changes to the selected fields for the displayed object, then click Next. Repeat for each additional object.

    Not all objects display.

    The query that runs after selecting the objects to sync also tests the size of the fields and number of records on an object. The Sync Wizard does not present a selection screen for an object if syncing the fields from that object do not add significant size to the sync packet.

  11. Click Finish to exit the wizard.

    image

Create an Additional Sync Profile

  1. From the Sync Wizard’s Sync Configuration screen, select Create config.

    image

  2. Enter a Config Name, then select Create.

  3. Select Let’s get started! and complete the wizard as described from step 5 in Create The Default Sync Profile above.

Manage Existing Sync Profiles

  1. From the Sync Wizard’s Sync Configuration screen, select the desired Active Config from the dropdown.

    image

  2. Enter a Config Name, then select Create.

  3. Select the option to modify from the menu on the left.

    The menu lists synced master data objects, then groups Transactional and Lookup Objects.
    • Wizard: Make changes by repeating the configuration wizard

    • Overview: Modify the Sync Mode, Editable Objects, and whether users Download Reports

    • Job and Pricebook Dispatch: Manage whether to use sync configurations to filter what syncs and review existing sync configurations

      image

    • Price Books: Manage the fields that sync for Price Books

    • Price Book Items: Manage the fields that sync for Price Book Items

    • Synced Objects: Change which objects sync to mobile devices

    • Transactional Objects: Display the list of transactional objects that sync and manage the fields for those objects

      Click the Back option in the next menu to return.

    • Lookup Objects: Display a list of lookup objects that sync and manage the fields for those objects

      Click the Back option in the next menu to return.

    • Raw Config: View the contents of the static resource file for the sync configuration profile

  4. Make changes and review any Sync Issues alerts by hovering over the red button.

    image

  5. Select Save before navigating to a different option.

Manage Filters

  • Add filters to objects as an additional layer to manage what syncs to mobile devices.

  • Filters use the AltSync flag on objects, which must be True for a record to sync.

  • Filters must be changed from the Default Config Sync Profile, as the filter is an object-level setting that applies to everyone.

    1. Access the Sync Configuration Wizard Admin Portal tool.

    2. Select Default Config from the Active Config dropdown.

      The filter options selected for the Default Config Sync Profile apply to all Sync Profiles.

    3. Select the desired object from the menu.

    4. If necessary, select the image arrow to expand the Filter records section.

    5. Select one of the following options:

      • No filter: Do not use AltSync for this object

      • Filter rows by activity (only available on Master Data and Lookup objects): Let FieldFX automatically select or deselect the AltSync flag on records

      • Filter rows manually (only available on Transactional objects): Use the AltSync flag, but a person selects and deselects the flag on records as needed

      • Filter rows by formula: Enter a SOQL statement in the AltSync Formula field that must evaluate to True for the record to sync

        Many objects have a recommended SOQL formula to use.

        Alerts display if the recommended setting is not entered, and the recommended formula displays in the Recommended AltSync Formula field that can be copied into the AltSync Formula field.

    6. Select Save, then repeat for other objects as needed.

      image