Reltio Unmerge

This snap unmerges the merged Reltio Objects (only Entities).

Table 1. Reltio Unmerge
Field Name Description
Snap Type: Write
Description:

This Snap is used to Unmerge the merged Reltio Objects (only Entities) on the mentioned Tenant. Based on the Snap's configuration it is also possible to unmerge composite Entities.

ETL Transformations & Data Flow

The Reltio Unmerge Snap transforms the merged Reltio Objects into separate unmerged entities.

Input & Output

  • Input: Input view is optional and is required only to pass the Origin Entity Id/ Spawn Entity Id from upstream Snaps or as a value in their corresponding properties.
  • Output: Response for the snap contains every field of each unmerged entity.

Modes

  • Ultra pipelines: May work in Ultra Pipelines.
  • Spark (Deprecated) mode: Not supported in Spark mode.
Prerequisites:

Reltio account with a valid Tenant Id so that Tenant URL can be formed/API for Account Settings. Also, the Reltio account must have write access in order to be able to create Objects in Tenant.

Limitations and Known Issues

None at the moment.

Configurations:

Account & Access

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Reltio Account for information on setting up this type of account.

Views

Input
This Snap has exactly one document input view.
Output
This Snap has exactly one document output view.
Error
This Snap has at most one document error view and produces zero or more documents in the view.
Troubleshooting: None at the moment.
Settings
Label

Required.

The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Tenant URL

Required.

This determines the Reltio host with Tenant Id. The format to be used is https://<reltio_host>/reltio/api/<tenant_id>.

Example: https://sndbx.reltio.com/reltio/api/XK178mXYr3UZrG6/

Default value: https://<your_reltio_host>/reltio/api/<tenant_id>

This value can be provided dynamically as a pipeline parameter or directly in the Snap but not as an upstream parameter.

Operations

This specifies the type of unmerge operation. Possible allowed values are Unmerge Entities and Not a potential match.

  • Unmerge Entities - This option performs unmerge of the provided Entity object
  • Not a Potential Match - This option removes the “Potential Matches” option from those two entities. <need more info>

Default value: Unmerge Entities

Origin Entity Id

Required.

The composite Entity Id which is the parent Entity ID (similar to Winner Id in Reltio Merge Snap) formed during the merge operation.

Default value: [None]

This value can be passed either as an upstream parameter or directly in the Snap but not as a pipeline parameter.

Spawn Entity Id

Required.

The Entity Id which is the child of merged Entity (similar to Loser Id in Reltio Merge Snap) formed during the merge operation.

Default value: [None]

This value can be passed either as an upstream parameter or directly in the Snap but not as a pipeline parameter.

Unmerge entity tree

This option can be used for composite Entity, an Entity that is the result of several merge operations. If enabled, every component (contributor) can be unmerged to be a standalone entity again. If not selected, only initial state of spawn without any merges would be unmerged.

Default value: Not selected

Retry limit

The maximum number of times the Snap will attempt to get the response. Since Reltio uses the exponential back off retry policy only for HTTP Status Codes 502, 503 and 504 and no retry policy for HTTP Status Codes 401, 403, 404, 500.

Default value: 5

Maximum value: 10

This value can be provided dynamically as a pipeline parameter or directly in the Snap but not as an upstream parameter.

Execute during preview

Executes the Snap during a pipeline Save operation so that the output view can produce the preview data.

Default value: Not selected

See the below examples for the basic and advanced use case and typical Snap configurations for the Unmerge operation.