Reltio Snap Pack: Migrating from the Field version to the Product version

In this article

This article explains the procedure to migrate existing SnapLogic Pipelines that use the Field version of the Reltio Snap Pack (Reltio Snap Connector) to the Product version of the Reltio Snap Pack.

Mapping the Reltio Snaps

Professional Services VersionProduct Version
Reltio Snap Connector Snap PackReltio Snap Pack
Reltio Snap Get by ObjectReltio Read (Object)
Reltio Snap Get by CrosswalkReltio Read (Crosswalk)
Reltio Snap Delete by ObjectReltio Delete (Object)
Reltio Snap Delete by URIReltio Delete (URI)
Reltio Snap MergeReltio Merge
Reltio Snap UnMergeReltio UnMerge
Reltio Snap WriteReltio Create
Reltio Generic Execute

None (Alternative Snap – REST Get)

Release Version 4.14: Reltio Generic Execute Snap

Reltio Relations Hierarchy None (Alternative Snap – Mapper)
NoneReltio Update
NoneReltio Bulk Export

At its initial launch, the Reltio Snap Pack did not have a counterpart Reltio Generic Execute Snap. At the time the REST Get Snap was suggested as the alternative. From release version 4.14 onward a Reltio Generic Execute Snap has been added. Steps for migrating from REST Get to Reltio Generic Execute are also added in this document.

Migrating the Reltio Professional Services Version to the Product Version

Before you begin

  • Subscribe to the Reltio Product version by contacting your SnapLogic Technical Account Manager or SnapLogic Support, requesting to enable the version for your orgs.
  • If your pipelines use the Reltio Generic Execute and Relations Hierarchy Snaps, then perform the additional steps listed in the subsequent sections that explain the procedure to replace those Snaps using the REST Get Snap and the Mapper Snap, respectively.

Steps

  1. Log in to the SnapLogic Elastic platform. In Manager, browse to the project folder of your existing pipeline and right click to Export the pipeline information. 


  2. In the Export projects dialog, select all the check boxes, except Account (since you will be later reconfiguring that information for the new Reltio Snaps).  

    1. Alternately, to migrate a single pipeline, open the same in Designer and click  on the top right menu bar to export the pipeline.

  3. Create a new project folder and then import the saved project/pipeline zip file to the new folder.


  4. Go to Manager > Snap Packs and select the default build for Reltio, for example: snapsmrc465 (default), or later, assuming that SnapLogic Support has enabled it for your orgs. You need admin permission to perform this step.


  5. Go to Designer > Snaps to view the Reltio Snap Pack in the catalog.


  6. Verify that the FQID of your existing PS Snap matches with that of the new Reltio Product version. If they differ, then you are probably comparing a different Reltio PS version. 


  7. Go to Designer > Pipelines, browse to your new project folder where you imported the existing pipelines and launch the pipelines that have the Reltio Snaps. However, the pipelines will not validate, due to the new parameters introduced in the Product version.

  8. For each Reltio Snap, enter the Reltio account and other Snap information. For instance, the new parameters. See the Mapping Parameters for Snaps table for more information.


  9. Save the pipeline to validate the new Reltio accounts and Snap configuration.

Mapping Parameters for Snaps

NameParametersChange in the Product Version

Professional Services (PS)Product
Account

Connect with your Amazon S3 bucket to export data to S3

LabelLabel--

UsernameUsername--

PasswordPassword--

OAuth2 TokenOAuth URL--

API KeyAPI Key--

--S3 Access-key IDNew parameter

--S3 Secret keyNew parameter




Reltio Read (Object)

Max one document as output (vs. max two documents as output in the PS version)

LabelLabel

--


Tenant URLTenant URL--

Object Object--

Object TypesObject Types--

--Object IdNew parameter

Query ParametersQuery Parameters--

ExplodeGroupParameter name changed

Maximum Request Attempts--Parameter removed

Retry Request IntervalRetry LimitParameter name changed




Reltio Read (Crosswalk)

Max one document as output (vs. max two documents as output in the PS version)

LabelLabel--

Tenant URLTenant URL--

ObjectObject--

Batch sizeBatch size--

--Thread limitNew parameter

Query parametersQuery parameters--

ExplodeGroup--

Maximum request attempts--Parameter removed

Retry request intervalRetry limitParameter name changed




Reltio Delete (Object)

--

LabelLabel--

Tenant URLTenant URL--

ObjectObject--

Object identifierObject Id--

--Bulk deleteNew parameter

Maximum request attempts--Parameter removed

Retry request intervalRetry limit--

Execute during previewExecute during preview--




Reltio Delete (URI)

--

LabelLabel--

Tenant URLTenant URL--

Reference URIURIReenter the URI value as it does not migrate from the PS version

Maximum request attempts--Parameter removed

--Bulk deleteNew parameter

--Retry limitNew parameter

Execute during previewExecute during preview--




Reltio Merge

Two different records (columns) can be combined into one in the Product version

LabelLabel--

Tenant URLTenant URL--

--OperationsNew parameter

--Winner IdNew parameter

--Loser IdNew parameter

Maximum request attempts--Parameter removed

Retry request intervalRetry limitParameter name changed

Execute during previewExecute during preview--




Reltio UnMerge

--

LabelLabel--

Tenant URLTenant URL--

--OperationsNew parameter

--Origin Entity IdNew parameter

-- Spawn Entity IdNew parameter

Unmerge entity treeUnmerge entity tree--

Maximum request attempts--Parameter removed

Retry request intervalRetry limit--

Execute during previewExecute during preview--




Reltio Create

--

LabelLabel--

Tenant URLTenant URL--

ObjectObject--

Object typesObject types--

Batch sizeBatch size--

Maximum threadsThread limitsParameter name changed

Maximum request attempts--Parameter removed

Retry request intervalRetry limitParameter name changed

Thread limitThread limit--

Query parametersQuery parameters--

Retry limitRetry limit--




Reltio Generic Execute

--

LabelLabel--

Http MethodHTTP MethodParameter name changed

Service UrlService URLParameter name changed

HTTP BodyHTTP Request BodyParameter name changed

Query parametersQuery parameters--

Raw dataRaw data--

Maximum request attemptsRetry limitParameter name changed

Retry request interval--Parameter removed

Execute during previewExecute during preview--

See the Reltio Help for information on Reltio functionality and parameters. You will need the Reltio account user credentials to access the help.

Migrating Reltio Generic Execute Snap to REST Get Snap

After migrating to the Product version of the Reltio Snap Pack per the above procedure, you will notice that the Generic Execute Snap in the canvas turns Red in color because it is unsupported in the Product version. You can use the REST Get Snap that has similar functionality as the Reltio Generic Execute Snap.

Steps

  1. On the Designer canvas, click the Generic Execute Snap to open its configuration window, and click the deleteicon to remove the Snap from the pipeline.
  2. From the Snaps catalog, drag the REST Get Snap at the same placement as the Generic Execute Snap.
  3. Enter the Service URL in the OAuth format (https://auth.reltio.com/oauth/token?grant_type=password&username=) and the API key via the HTTP header (see the After Migrating section below).
  4. Click on the Rest Get Snap connector and retrieve the access token. 
  5. In the downstream Rest Get Snap, enter the Service URL, for example, https://sndbx.reltio.com/reltio/api/XK178mXYr3UZrG6/entities?filter=(equals(type,'HCP')) and the access token ID in the HTTP header value.
  6. Provide the remaining configuration information (per your requirements) as given in the REST Get Snap document.
  7. Click Save to validate the pipeline.

Example 

Before Migrating


After Migrating

Migrating from the REST GET Snap to Reltio Generic Execute Snap


This is applicable only if you have already mapped the parameters in the Professional Services' version of the Reltio Generic Snap to the REST GET Snap and now wish to replace it with the Product Version of the Reltio Generic Execute Snap.

Steps

  1. On the Designer canvas, click the REST GET Snap to open its configuration window and click the deleteicon to remove the Snap from the pipeline.
  2. From the Snaps catalog, drag the Reltio Generic Execute Snap at the same placement as the REST GET Snap.
  3. Configure the Account settings for the Snap as you would the other Reltio Snaps.
  4. Enter the service URL in the required format in the Service URL property.
  5. Select the operation applicable from the HTTP Method property.
  6. Provide the remaining configuration information (per your requirements) as given in the Reltio Generic Execute Snap document.
  7. Click Save and validate the pipeline.

Migrating Reltio Relations Hierarchy Snap to Mapper Snap

After migrating to the Product version of the Reltio Snap Pack per the above procedure, you will notice that the Generic Execute Snap in the canvas turns Red in color because it is unsupported in the Product version. You can use the Mapper Snap that has similar functionality as the Reltio Relations Hierarchy Snap.

Steps

  1. On the Designer canvas, click the Relations Hierarchy Snap to open its configuration window, and click the deleteicon to remove the Snap from the pipeline.
  2. From the Snaps catalog, drag the Mapper Snap at the same placement as the Relations Hierarchy Snap.
  3. Pass the input data and transform the data based on the hierarchy from the Mapper snap.
  4. Provide the remaining configuration information (per your requirements) as given in the Mapper Snap document.
  5. Click Save to validate the pipeline.

Example 

Before Migrating

After Migrating

Deleting the PS Snap Pack

After the existing pipelines successfully execute in the new Reltio Snap Pack Product version, you may optionally delete the PS Snap Pack and related pipelines. 

Go to Manager > Snap Packs, browse to the project in which the Reltio PS Snap Pack pipelines exist and delete the same. Repeat this step for each org and project that you have full access to.

See Also