Synchronization F.A.Q.

Here is a list of frequently asked questions:

Synchronization Modes

When to launch the full synchronization?

The first full synchronization must be launched after the authorization of the current user in order to download the current user database (data, metadata, app settings).

  • The sync process may take a lot of time, depending on the database size.

When to launch the fast synchronization?

Fast synchronization is the preferred type for daily work with the CT Mobile app. We recommend doing a fast synchronization once a day at the beginning or end of the work day to maintain data consistency in the CT Mobile app and Salesforce.

The sync process may include CT Mobile Replication.

When to launch the mixed synchronization?

The mixed synchronization is intended to align the records' main information and update metadata since the date of the last successful synchronization.

The sync process may include CT Mobile Replication. ===

We recommend running mixed synchronization in case of metadata changes, for example:

  • adding lookup filters;

  • updating layouts for records;

  • changing validation rules

  • etc.

When to use CT Mobile Replication?

We recommend using CT Mobile Replication when you changed sharing rules (via organization-wide defaults or per each record). In this case, create a CT Mobile Replication setting to keep data up to date on the device. The corresponding records will be downloaded and records, which are no longer available, will be hidden.

What synchronization mode should I use when updating CT Mobile?

When updating the CT Mobile app, we recommend:

  1. Run the fast synchronization.

  2. Remove the previous version of the CT Mobile app from the mobile device.

When we release the new version of CT Mobile, we check its compatibility with the previous version and let you know if removing the CT Mobile app can be skipped. In this case, run the fast synchronization, install a new version of CT Mobile on top of an existing one, and then run the mixed synchronization for the correct operation of the CT Mobile app. . Install the new version of the CT Mobile app. . Run first full synchronization.

CT Mobile is ready to use.

How to know that the synchronization is successful?

If the synchronization was successful, the notification appears. Also, the status indicator in the lower left corner shows the date of the last successful synchronization.

Synchronization Details

In what order are records synchronized?

During any synchronization mode, the parent records are synchronized first, and then their child records are synchronized. To learn more about the steps for each synchronization mode, refer to Synchronization Launch.

Does the application lock during the sync process?

The mobile application is available to work during any synchronization mode. Also, you can collapse Mobile, and a system notification will pop up when the synchronization is complete.

Where are the synchronization statistics stored?

Enable logs on the CT Mobile Control Panel: General tab to collect statistics in the Sync Log object. The Sync Log record for the selected synchronization type keeps:

  • Operation

Currently, there are two available types:

  • Sync Log History is used to store statistics for any synchronization

  • Export Data is used to send changes made in the CT Mobile app but is not yet synchronized.

    • Status

    • Date

    • Description

    • Duration

    • The number of transmitted records

    • The number of errors occurred.

    • Failed Messages

Metadata Archive and Related Errors Handling

What components are included in the metadata archive?

The list of components is available here. Also, the metadata archive includes all offline objects that were specified on the CT Mobile Control Panel: Offline Objects.

How often to rebuild the metadata archive?

The frequency depends on the frequency of updating settings on the CT Mobile Control Panel tabs, changing lookup filters, creating custom labels, managing validation rules, etc.

Why were not the up-to-date metadata components downloaded?

The metadata archive has not been updated. Go to the CT Mobile Control Panel: Tools tab and click the Refresh metadata archive button.

Synchronization Error Handling

How to send the application data dump?

Go to the Settings screen and tap the Send database button to create a ZIP archive with the app database and send it via the standard Share menu on Android devices.

What to do if the sync process is interrupted due to a lack of an Internet connection?

If the Internet is interrupted during the sync process, you will see a «Network unavailable» notification. In that case:

  1. Connect your device to the Internet and wait for a while for the device to start all the necessary services.

  2. Tap the Start Fast Sync icon in the lower-left corner to start the sync process.

  3. In the pop-up, tap Start full sync to run the mixed synchronization or tap Start fast sync anyway to launch the fast synchronization.

When the sync process is complete, CT Mobile is ready to work.

What to do if the INSUFFICIENT ACCESS error occurs?

The error occurs when access to the records has been revoked. For example, a mobile user created an Activity record for an Account record, and the manager in Salesforce revoked the user’s access to that Account. When the mobile user runs a fast synchronization to submit the created Activity record, they will receive an Insufficient Access error.

To solve this problem, contact your administrator, request to restore access to the parent record, and run a fast synchronization afterward.

What to do if the mobile user is not allowed to edit the field?

The error occurs when access to a field has been revoked. For example, while creating a record, a mobile user filled out the field, and the manager in Salesforce revoked the user’s permission to edit that field. When the mobile user runs a fast synchronization to submit the created record, they will receive an Unable to create/update fields error.

To solve this problem, contact your administrator, request to restore access to the field, and run a fast synchronization afterward.

What to do if the validation error occurs?

The error occurs when the validation rules are violated. For example, while creating a record, a mobile user filled out a field with a value that violates the validation rule created in Salesforce after the last successful synchronization. When the mobile user runs a fast synchronization to submit the created record, they will receive the validation error with the error description.

To solve this problem, go to the Validation Errors screen, tap the record to open it, fix the error, and run a fast synchronization afterward.

``