Sync Event Viewer
Prerequisites
-
To use the Sync Event Viewer, you need the following licenses:
-
To use the Sync Event Viewer, you must:
Basics
-
The Sync Event Viewer is a sync administration tool available in the Admin Portal for orgs using the Auto Sync feature.
-
Use the Sync Event Viewer to resolve sync upload errors.
The ability to automatically upload data from FieldFX Mobile to FieldFX Back Office is still under development and requires setup not currently described in this documentation site. Contact support for more information. -
If your org has not enabled auto sync, use the Sync Health Board instead.
Permissions
Permission Set
For data to load to the Sync Event tool, assign the SyncEventPermissions permission set to FieldFX Mobile users and admins. This permission set grants the permissions detailed below.
System Administrators
To resolve sync upload errors in the Sync Event Viewer, you need:
-
Object Permissions
Object Read Create Edit Delete View All Modify All Sync Event
-
Field Permissions#
Object Field Read Edit Sync Event
All Fields
FieldFX Mobile Users
To record your syncs in the Sync Event Viewer, you need:
-
Object Permissions
Object Read Create Edit Delete View All Modify All Sync Event
-
Field Permissions
Object Field Read Edit Sync Event
All Fields
Getting There
-
Go to https://admin.fieldfx.com and login with your Salesforce org credentials
-
Click Sync Event Viewer
|
The first time you access the Sync Event Viewer, the tool queries the entire history in the Audit Log. This may take an extended period of time to complete. When you come back to the tool again, the Sync Event Viewer loads much more quickly. |
Unresolved Events Page
Basics
-
The Unresolved Events page displays when you first log in.
Figure 1. Unresolved Events provides a summary view -
This page features a list of users that have unresolved sync upload errors.
-
Sync upload errors are bundled together by user to make fixing errors easier.
User Events Page
Basics
-
The User Events page displays when you click View next to a user on the Unresolved Events page.
Figure 2. Click View to display a list of the events for the user -
This page displays the unresolved sync upload errors for the specified user, sorted in chronological order.
-
Use this page to resolve sync upload errors.
Events
Event Types
Following are the possible event types:
| Event | Description |
|---|---|
create Attachment |
User attached an FX Report to a record |
create FX5__Job__c |
User added a job |
update FX5__Job__c |
User edited a job |
create FX5__Ticket__c |
User added a ticket |
update FX5__Ticket__c |
User edited a ticket |
create FX5__Ticket_Item__c |
User added a ticket item |
update FX5__Ticket_Item__c |
User edited a ticket item |
delete FX5__Ticket_Item__c |
User deleted a ticket item |
create FX5__Quote__c |
User added a quote |
update FX5__Quote__c |
User edited a quote |
create FX5__Quote_Item__c |
User added a quote item |
update FX5__Quote_Item__c |
User edited a quote item |
delete FX5__Quote_Item__c |
User deleted a quote item |
create FXFORMNAMEHERE__c |
User added an FX Form |
update FXFORMNAMEHERE__c |
User edited an FX Form |
Fields
The following fields display on the User Events page:
| Field | Description |
|---|---|
Date/Time |
Date and time of the event that caused the sync upload error |
Tracking Number |
Tracking number of the record that caused the sync upload error |
Sync Id |
Last 8 digits of the Sync Id for the record that caused the sync upload error |
Type |
Type of event that caused the sync upload error |
Event Status Indicators
Errored
Displays the reason for the sync upload error.
Hover over the exclamation mark icon to see the Salesforce error message.
Modified
Displays on events you have edited.
Ignored
Displays on events you selected to ignore.
Select the checkbox next to an event to mark it to be ignored.
| After selecting the event(s) to ignore, click X Delete Ignored at the bottom of the screen. |
Event Details
Click Details on an event to display the Event Details window.
The Event Details window displays the fields completed during an event.
Click Edit to make changes to the event data.
| When editing an event, click X next to a field to remove it from the sync packet. |
Click Show Raw to view the event data in JSON (JavaScript Object Notation) form.
| Click Edit to make changes to the event in JSON form. However, this is not recommended. |
FX Reports
Click View on a create Attachment event to view the FX Report attached to a record during that event.
You can then print or save the report.
Best Practices
Remember to resolve each sync upload error individually before you reprocess a full list of events.
Step-by-Step Guides
Editing an Event
-
Click Details on the event
-
Click Edit
-
Make changes
Click X next to a field to remove it from the event -
Click Done
-
Click Apply Changes
The Modified Indicator now displays on the event.
Restoring a Deleted Record
-
Locate an event that features the deleted record
-
Click the link to the deleted record
-
Select the checkbox next to the deleted record
-
Click Undelete
Preprocessing Events
Preprocessing Events for User
-
Resolve the sync upload error(s):
-
Select the Errored indicator on the first event
The error message displays
Figure 8. Hover over the error message to display the error details -
Complete the following:
-
If the error states that a record was deleted or no longer exists, restore the deleted record and proceed to step 2.
-
If the error states that a field contains invalid data, correct the data and proceed to step 2.
-
If there are no obvious issues with the fields or records in the event, proceed to step 2.
-
-
Repeat steps a and b until you resolve every sync upload error
-
-
Delete events that should not reprocess:
-
Mark the checkbox for each event that should not reprocess
-
Click X Delete Ignored
-
-
Click Preprocess Events for User