Add Value to Synchronize

The default value mappings are described in the Default Value Mappings section. These mappings can be changed, and new mappings can be added.

In order to add a new field, you must know the attribute from the Salesforce contact that you want to read, and the property on the xDB contact that you want to write.

Identify Salesforce Contact Field

Your Salesforce administrator is able to provide you with the names of the fields that are available in your Salesforce account.

Identify xDB Contact Property

Values are stored on xDB contacts through contact facets. The contact facets that are available on your Sitecore server depend on how your system has been configured.

Your Sitecore administrator is able to provide you with the information about the available contact facets and the values stored on each.

Define Value Accessors

A value accessor represents a value that can be read or written during the synchronization process. Two value accessor items must be created: one for the Salesforce contact field and the xDB contact property identified in the previous steps.

Value Accessor for Salesforce Contact

The value accessor for the Salesforce contact is used to read the field whose value is written to the xDB contact.

  1. In Content Editor, navigate to your tenant.
  2. Navigate to Data Access > Value Accessor Sets > Providers.
  3. Navigate to Salesforce > Salesforce Contact Fields.
  4. Insert a new item using the template Sitecore Object Field Value Accessor.
  5. In the field Field name, enter the name of the field from the section Identify Salesforce Contact Field.
  6. Save the item.

Value Accessor for xDB Contact

The value accessor for the xDB contact is used to write the value read from the Salesforce contact to the xDB contact.

Defining the value accessor for the xDB contact is more complicated than the one for the CRM contact. There is a much greater variety of ways that data can be stored on an xDB contact than on a Salesforce contact.

As a result, you must select the appropriate template for the value accessor.

Tip

The available templates are described in the Data Exchange Framework documentation.

  1. Navigate to your tenant.
  2. Navigate to Data Access > Value Accessor Sets > Providers.
  3. Navigate to Sitecore > xDB Contact Entity Fields.
  4. Insert a new item using the template that is appropriate for the value identified in the section Identify xDB Contact Property.
  5. Set the required fields.
  6. Save the item.

Define Value Mapping

A value mapping associates the value accessor used to read a value with the value accessor used to write a value.

In this case, the value mapping associates the value accessor used read the attribute value from a Salesforce contact with the value accessor used to write the property value to an xDB contact.

  1. In Content Editor, Navigate to your tenant.
  2. Navigate to Value Mapping Sets > Salesforce Contact to xDB Contact.
  3. Insert a new item using the template Value Mapping.
  4. In the field Value accessor for source object, select the Value Accessor for Salesforce Contact.
  5. In the field Value accessor for target object, select the Value Accessor for xDB Contact.
  6. Save the item.

This setting will take affect the next time the synchronization process runs.