Accelerate the Value of Data

Reltio Entity to Salesforce Object Conversion

This API converts Reltio entities to Salesforce objects for preview, without posting the data.

The result contains all objects transformed into a format that Salesforce will allow during the synchronization process.

Request

POST: {SFDCConnectorUrl}/mapper/{tenant}/{profile}/convert/to_salesforce
Table 1. Parameters
Parameters Name Required Description Example
Headers authorization true Authorization header Bearer {oauth_token}
Path tenant true Reltio tenantId someTenant
Path profile true Profile Id 000000000000012345
Query callback false Add entity callback to the response callback=true
Body true Array of entities/relations to convert to sobjects
[
  {
    "uri": "entities/1",
    "type": "configuration/entityTypes/HCP",
    "attributes": { ... },
    "crosswalks": [ ... ]
  },
  {
    "uri": "relations/1",
    "type": "configuration/entityTypes/Affiliation",
    "attributes": { ... },
    "crosswalks": [ ... ]
  }
]

Response

The response is an array of JSON objects and each object has parameters:

Name Description Example
objects List of sobjects converted from entity
"objects": [
  {
    "attributes": {
      "type": "Account",
      "uri": "entities/1"
    },
    "Id": "003f400001InGJ1AAN",
    "recordTypeId": "00001",
    "FirstName": "FirstName",
    "LastName": "LastName",
    "relatedObjects": []
  }
]
callback List of entity JSON to be posted to Reltio
"callback": [
  {
    "type": "configuration/entityTypes/HCP",
    "uri": "entities/1",
    "attributes": {
      "FirstName": [
        {
          "value": "FirstName",
          "uri": "entities/1/attributes/FirstName/1"
        }
      ],
      "LastName": [
        {
          "value": "LastName",
          "uri": "entities/1/attributes/LastName/1"
        }
      ]
    },
    "crosswalks": [
      {
        "type": "configuration/sources/SFDC",
        "sourceTable": "Account",
        "uri": "/003f400001InGJ1AAN",
        "value": "003f400001InGJ1AAN"
      }
    ]
  }
]
filtered Indicates if the entity is filtered according to mapping (cannot be applied for the entity attribute), during synchronization
[
  {
    "objects": [],
    "callback": [],
    "filtered": false
    ]
  }
]
errors Array of error messages if error occurred during the execution of operation for the corresponding Reltio Type
"errors": [
      "Mapping for 'configuration/entityTypes/HCO' and tenant 'HGFYOZboMbwGyFP+
00Df4000000n29UEAQ' not found"
    ]

Full Response Example

[
  {
    "objects": [
      {
        "attributes": {
          "type": "Account",
          "uri": "entities/1"
        },
        "Id": "ID1",
        "recordTypeId": "00001",
        "FirstName": "FirstName",
        "LastName": "LastName",
        "relatedObjects": []
      }
    ],
    "callback": [
      {
        "type": "configuration/entityTypes/HCP",
        "uri": "entities/1",
        "attributes": {
          "FirstName": [
            {
              "value": "FirstName",
              "uri": "entities/1/attributes/FirstName/1"
            }
          ],
          "LastName": [
            {
              "value": "LastName",
              "uri": "entities/1/attributes/LastName/1"
            }
          ]
        },
        "crosswalks": [
          {
            "type": "configuration/sources/SFDC",
            "sourceTable": "Account",
            "uri": "/003f400001InGJ1AAN",
            "value": "003f400001InGJ1AAN"
          }
        ]
      }
    ],
    "filtered": false
  },
  {
    "errors": [
      "Mapping for 'configuration/entityTypes/HCO' and tenant 'HGFYOZboMbwGyFP+00Df4000000n29UEAQ' not found"
    ]
  }
]