Sync Upload Errors

Basics

  • A sync upload error occurs when Auto Sync data from FieldFX Mobile doesn’t sync successfully to FieldFX Back Office.

  • The Audit Log records a sync upload error in a SyncUploadError entry.

  • You must resolve sync upload errors as soon as possible.

Sync Upload Errors vs. Sync Failures

When a sync upload error occurs:

When a sync failure occurs:

  • The sync fails and an error message displays on the Home page

  • You need to resolve the failure by troubleshooting the issue

Best Practices

Avoiding Sync Upload Errors

Don’t delete quotes, jobs, or tickets in FieldFX Back Office.

Don’t add validation rules in FieldFX Back Office that could invalidate data synced from FieldFX Mobile.

Don’t use high-resolution images for FX Reports.

  • Use low-resolution images for logos.

  • Only attach low-resolution photos or stamps.

  • Keep the file size of each report below 1.5 MB.

Resolving Sync Upload Errors

  • Set up email notifications so that system administrators receive alerts when sync upload errors occur.

  • Resolve sync upload errors immediately because one error can cause further errors.

  • Always resolve the oldest sync upload error first.

Common Sync Upload Errors

Many errors are due to a lack of permissions.

Make sure FieldFX Mobile users and Admins have the Sync Event Permissions permission set assigned, as well as other permissions needed for the appropriate objects for the sync event.

This table lists common sync upload errors and how to resolve them

Message Trigger Resolution

CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY

Permissions to the record have changed

Restore missing permissions to the record

ENTITY_IS_DELETED

Field user has referenced a record that has been deleted

Restore deleted record

FIELD_CUSTOM_VALIDATION_EXCEPTION

Field user data fails validation

Correct the data so it passes validation
Suggested best practice: ensure Back Office validation rules match Mobile validation rules

FIELD_FILTER_VALIDATION_EXCEPTION

Field user data does not meet lookup filter criteria

Correct the data so it matches the lookup filter criteria
Suggested best practice: ensure Back Office lookup filters match Mobile lookup filters

INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY

Field user does not have permissions for related record

Update permissions for the user to the specific record

INVALID_FIELD_FOR_INSERT_UPDATE

Field user has added a child record to deleted parent

Restore parent record

NOT_FOUND

  1. Field user has referenced a record that has been delete

  2. Permissions to the record have changed

  1. Restore deleted record

  2. Restore missing permissions to the record

UNABLE_TO_LOCK_ROW

Record was being edited while sync occurred

Wait for record to be out of editing and re-sync