Merging Using Reltio URIs
Using this API you can forcefully merge Salesforce Reltio Objects by providing a list of URIs.
The merge synchronization happens in sync
mode, and the Reltio
Objects will be added to the Salesforce Connector queue in due request runtime and will be processed
in the future (when the connector processes this particular set of URIs).
Usage Scenarios
mergeByUris
endpoint may be used:
- To resolve inconsistency issues in case the merge has not been turned off for the corresponding entity type, but data has been already loaded to the tenant.
- To retry merge in case the previous attempt has failed.
Request
POST: {SFDCConnectorUrl}/synchronization/{tenant}/{profile}/mergeByUris
Parameters | Name | Required | Description | Example |
---|---|---|---|---|
Headers |
Authorization |
true | Authorization header | Barer {oauth_token} |
Path |
tenant |
true | Reltio tenant Id | SomeTenant |
profile |
true | Profile Id | 000000000000012345 | |
Body |
true | An array of entities or relations for corresponding object Type. Max size of all objects should not be greater than 1000. |
|
Response
The response is in JSON format with parameters.
Name | Description | Example |
---|---|---|
reltioType |
Corresponding Reltio Object Type from Request | configuration/entityTypes/Contact |
{Reltio Object Id}
/state
/reason |
Reltio Object Id with state and reason for adding a particular Object to the synchronization queue |
|
errors |
An array of error messages if an error occurred during an operation execution for the corresponding Reltio Type |
|
Possible Errors
The response is in JSON format with parameters.
Name | Description | Example |
---|---|---|
400 |
The tenant '${tenant}' or profile '${profile}' are not registered. | Tenant or Profile is not
registered. |
400 |
Incoming data should be valid JSON data. | Wrong BODY format - has to be valid JSON data. |
400 |
Incoming data should be an Object. | Wrong BODY format - has to be Object. |
400 |
Should be array data with size not more than 1000. | Number of all objects in the BODY should be
lesser than 1000 . |
200 |
Merge is switched off for Reltio type '${type}. | Merge is forbidden for this entity type. Turn on the merge in the mapping. |
200 |
'${uri}' is not valid URI. | Invalid URI. |
200 |
entity ${uri} not found. | The entity does not exist. |
200 |
The entity is not suitable for sync. There are less than two active salesforce crosswalks. | The merge operation is not required for this entity as there is nothing to be merged. |
200 |
Sync disabled for record{uri}. | The entity is filtered out. Verify the mapping filter for the corresponding type. |