Accelerate the Value of Data

Salesforce Mapping Debug API

Salesforce Mapping Debug API allows you to preview how a record will appear when sent from Salesforce to Reltio or Reltio to Salesforce, without actually posting the record.

The Mapping debug API helps to troubleshoot data mapping, verify data filtering, and perform validation and transformation between Salesforce and Reltio. Salesforce allows two types of data conversion operations:

The convert/to_salesforce endpoint takes an array of entities and relations in the request. You can use the response structure of Get Entity by URI API, as the input payload for convert/to_salesforce endpoint. The response is also an array of objects transformed based on the mapping and validation from Reltio to Salesforce. The response is not posted to the Salesforce database but is only available for preview and troubleshooting errors. For more information, see Get Entity.

The convert/to_reltio endpoint takes a list of Salesforce sobjects. The sobject JSON is generated by a managed package on the Salesforce side when an object is created or updated.

To obtain a Salesforce sobject JSON:
  • Click File and then click Open in the developer console.
  • Select Objects and click Reltio_Sync__c.
  • Query the records from the database. The JSON_Object__c field contains the sobject JSON.

The response is a list of entities and relations transformed based on the mapping and validation from Salesforce to Reltio. The response is not posted to the Reltio database but is only available for preview and troubleshooting errors.

You can also verify the entity or sobject filtering using the convert/to_salesforce and convert/to_reltio endpoints. For example, when you create or update a new entity, the Salesforce connector synchronises it with the Salesforce object, according to the mapping. If the entity does not satisfy the filter configured in the mapping, it will get filtered out. The filtered property in the response, shows if an entity is synchronized to Salesforce after an entity update.

You must have the following roles to enable the Mapping debug API:
  • ROLE_SFDC_CONNECTOR