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 Version | Product Version |
|---|---|
Reltio Snap Connector Snap Pack | Reltio Snap Pack |
Reltio Snap Get by Object | Reltio Read (Object) |
Reltio Snap Get by Crosswalk | Reltio Read (Crosswalk) |
Reltio Snap Delete by Object | Reltio Delete (Object) |
Reltio Snap Delete by URI | Reltio Delete (URI) |
Reltio Snap Merge | Reltio Merge |
Reltio Snap UnMerge | Reltio UnMerge |
Reltio Snap Write | Reltio Create |
Reltio Generic Execute | None (Alternative Snap – REST Get) Release Version 4.14: Reltio Generic Execute Snap |
Reltio Relations Hierarchy | None (Alternative Snap – Mapper) |
None | Reltio Update |
None | Reltio 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
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.
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).
Alternately, to migrate a single pipeline, open the same in Designer and click
on the top right menu bar to export the pipeline.
Create a new project folder and then import the saved project/pipeline zip file to the new folder.
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.Go to Designer > Snaps to view the Reltio Snap Pack in the catalog.
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.
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.
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.
Save
the pipeline to validate the new Reltio accounts and Snap configuration.
Mapping Parameters for Snaps
Name | Parameters | Change in the Product Version | |
|---|---|---|---|
| Professional Services (PS) | Product |
|
Account |
|
| Connect with your Amazon S3 bucket to export data to S3 |
| Label | Label | -- |
| Username | Username | -- |
| Password | Password | -- |
| OAuth2 Token | OAuth URL | -- |
| API Key | API Key | -- |
| -- | S3 Access-key ID | New parameter |
| -- | S3 Secret key | New parameter |
|
|
|
|
Reltio Read (Object) |
|
| Max one document as output (vs. max two documents as output in the PS version) |
| Label | Label | -- |
| Tenant URL | Tenant URL | -- |
| Object | Object | -- |
| Object Types | Object Types | -- |
| -- | Object Id | New parameter |
| Query Parameters | Query Parameters | -- |
| Explode | Group | Parameter name changed |
| Maximum Request Attempts | -- | Parameter removed |
| Retry Request Interval | Retry Limit | Parameter name changed |
|
|
|
|
Reltio Read (Crosswalk) |
|
| Max one document as output (vs. max two documents as output in the PS version) |
| Label | Label | -- |
| Tenant URL | Tenant URL | -- |
| Object | Object | -- |
| Batch size | Batch size | -- |
| -- | Thread limit | New parameter |
| Query parameters | Query parameters | -- |
| Explode | Group | -- |
| Maximum request attempts | -- | Parameter removed |
| Retry request interval | Retry limit | Parameter name changed |
|
|
|
|
Reltio Delete (Object) |
|
| -- |
| Label | Label | -- |
| Tenant URL | Tenant URL | -- |
| Object | Object | -- |
| Object identifier | Object Id | -- |
| -- | Bulk delete | New parameter |
| Maximum request attempts | -- | Parameter removed |
| Retry request interval | Retry limit | -- |
| Execute during preview | Execute during preview | -- |
|
|
|
|
Reltio Delete (URI) |
|
| -- |
| Label | Label | -- |
| Tenant URL | Tenant URL | -- |
| Reference URI | URI | Reenter the URI value as it does not migrate from the PS version |
| Maximum request attempts | -- | Parameter removed |
| -- | Bulk delete | New parameter |
| -- | Retry limit | New parameter |
| Execute during preview | Execute during preview | -- |
|
|
|
|
Reltio Merge |
|
| Two different records (columns) can be combined into one in the Product version |
| Label | Label | -- |
| Tenant URL | Tenant URL | -- |
| -- | Operations | New parameter |
| -- | Winner Id | New parameter |
| -- | Loser Id | New parameter |
| Maximum request attempts | -- | Parameter removed |
| Retry request interval | Retry limit | Parameter name changed |
| Execute during preview | Execute during preview | -- |
|
|
|
|
Reltio UnMerge |
|
| -- |
| Label | Label | -- |
| Tenant URL | Tenant URL | -- |
| -- | Operations | New parameter |
| -- | Origin Entity Id | New parameter |
| -- | ||
Have feedback? Email documentation@snaplogic.com | Ask a question in the SnapLogic Community
© 2017-2025 SnapLogic, Inc.