Configure field mapping

Audience:
settings
• 3 minutes to read
 • 3 minutes to read

When synchronizing data between SuperOffice and ERP systems, must specify which SuperOffice field and which ERP field belong together.

Note

When editing an ERP connection, you must first deactivate it.

  1. Select Quote/Sync > Sync. In the ERP connections list uncheck the Active box for the ERP connection you want to edit.

  2. Select the ERP connection, and click the Mappings button at the bottom. The Mappings dialog displays the tabs for the available actors in the ERP system.

  3. Select the tab for the actor for which you want to configure allocations.

  4. Check Sync ERP [actor] to SuperOffice [entity].

  5. In the list below, select the synchronization direction and which SuperOffice field each ERP field should be allocated to (synchronized with). You can also choose if the fields should be displayed in searched and the ERP tab. The list consists of the following columns:

    • Show in Search: Check here if this field should be displayed in search results.

    • ERP Field: Shows the name of the field in the ERP system.

    • Direction: Here you select the direction(s) for the synchronization. See table of icons below.

    • SuperOffice Field: here you choose which SuperOffice field you want to synchronize. Some fields (such as customer and contact IDs) cannot be synchronized and the list will then be empty.

    • Show In ERP Tab: check here if you want this field to be displayed in the ERP tab in SuperOffice CRM (Company, Contact, and Project screen).

      Note

      If you have chosen to synchronize this field with a SuperOffice field, there is no point in displaying the field in the ERP tab.

  6. Repeat steps 4 to 6 to configure field allocations for other actors.

  7. Click Done to finish. Below the ERP connections list, all the fields that are synchronized for the different actors are shown.

  8. Check Active for the ERP connection you edited.

What does the icons mean?

Icon Explanation
icon No synchronization (SuperOffice field is selected). If the field is mandatory, you MUST choose a direction.
icon Sync both ways.
icon Sync from SuperOffice to the ERP system.
icon Sync from the ERP system to SuperOffice.
icon No synchronization (SuperOffice field is NOT selected), or the field cannot be synchronized (for example, customer name). This can also be due to read-only fields. Mouse-over the icon to view details.
Note

The arrows are disabled until you select a SuperOffice field.

Troubleshooting

If you defined incorrect settings for the field allocations, you will receive a descriptive error message. This would apply for instance to a mandatory field without a synchronization direction. You must correct the error before you can activate the ERP connection.

How to map/allocate list items

If you mapped any lists (for example category), you must also map the individual items on each list.