This Snap reads the Reltio objects from a specified Tenant.
ETL Transformations & Data Flow
This Snap reads the Reltio data from the provided Object and Object Type.
Input & Output
Input: One input view. This view to provides the type or the value which is also suggested in the Input Schema. Only the fields marked with an asterisk ( * ) are the required inputs; all other fields are optional.
Output: The response contains the attributes value for each entity object provided. There is a separate response record for each input entity.
Spark (Deprecated) mode: Not supported in Spark mode.
Prerequisites:
A valid Reltio account with the tenant ID for the Tenant URL, or an API key for the Account Settings to be generated.
The Reltio account must have sufficient access to read the objects from the Tenant.
Limitations and Known Issues:
None at this time.
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.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:
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. Specifies the Reltio host with Tenant ID. Use this format: https://<reltio_host>/reltio/api/<tenant_id>
The values can be passed directly or by using the pipeline parameters, but not through the upstream Snap.
Required. The Reltio object to be read. This is a suggestible field. Reltio typically has four objects:
Entities: Entities are objects for the representation such as People,Company, and Locations.
Categories: Entities are structured under the Categories. An entity can belong to multiple categories.
Interactions: Interactions are the actions between two or more entities that have an impact on one another. For example: email is an interaction that sends emails to one or several entities. Depending on the business model, you can also define different types of interactions in their instance.
Relations: Relations define the links between entities.
The suggestion works only when the valid account or the tenant URL is provided.
The values can be passed directly or by using the pipeline parameters.
Default value: [None]
Object Types
Required. The suggestible field provides options to choose an object type for a particular Object. The suggestion works only when a valid Account, Tenant URL and Object are provided.
This value can be provided dynamically as a pipeline parameter or directly in the Snap but not as an upstream parameter.
Detault value: [None]
Object Id
The object ID describes the part of 'uri' of the Reltio API response.
For example: “uri”: “entities/abcd1234” is a part of Reltio Object (Entity here) so abcd1234 is the Object Id (Entity Id here). In Reltio UI, it says like “Entity ID” in profile of each Entity Object.
This is either being taken fromupstream or pipeline parameters.
Default value: [None]
Records to Read
Specifies the number of records to read from an object. The available options are:
Up to 200 records: The Snap retrieves records up to 200 from the specified Reltio object/ object type
All records: The Snap retrieves all the records from the specified object/object type (except "interactions" object) .
Page Size
Conditional. Specifies the page size to be set for the Reltio read functionality. This property is applicable only when the option, All records is selected on Records to Read property for Relations object. The Snap sets the pagination for the records in the Relations object. The values can be passed using the pipeline parameters or via the upstream Snaps. The minimum value may be 1 and there is no upper bound for this property.
Default value: 100
Query parameters
Defines the query parameters and their values. The query parameters are attached to the URL using the http query parameter syntax, separated by '&' and are added as 'key=value' pairs. For example, when Expression is disabled, the Query Parameter 'max' with the key Value '5' displays the five records of the Object on the output preview.
Query parameter
Specifies the key used in the HTTP request for Reltio.
Default value: [None]
Query parameter value
Specifies the key value for the particular Query parameter used.
Default value: [None]
Group
Nests multiple values of the same attribute by grouping them into a single tag. If not selected, then an attribute with multiple values is displayed in two separate tags.
Default value: Not selected
Retry limit
Determines the maximum number of attempts to retrieve the response. Reltio uses the exponential backoff retry policy only for HTTP Status Codes 502, 503 and 504. Reltio has no retry policy for HTTP Status Codes 401, 403, 404, 500.
The values can be passed directly or by using the pipeline parameters.
Default value: 5
Maximum value: 10
Basic Use Case
The following pipeline describes how the Snap functions as a standalone Snap in a pipeline:
Typical Snap Configurations
The key Snap configurations are:
Without Expressions
The values are directly passed into the Snap:
With Expressions
Query from Upstream In the Snap settings shown below, the ID value is passed using an upstream Snap:
Pipeline Parameter In the configuration shown below, the values (Tenant URL, Object and Object types) are passed using the pipeline parameters:
The values as set in the Pipeline parameters:
Downloads
File
Modified
No files shared here yet.
Snap Pack History
Click to view/expand
Release
Snap Pack Version
Date
Type
Updates
August 2024
438patches28012
Latest
Added the Reltio OAuth2 Accountthat authenticates the user via the Client credentials Grant type.
August 2024
main27765
Stable
Updated and certified against the current SnapLogic Platform release.
May 2024
main26341
Stable
Updated and certified against the current SnapLogic Platform release.
February 2024
main25112
Stable
Updated and certified against the current SnapLogic Platform release.
November 2023
main23721
Stable
Updated and certified against the current SnapLogic Platform release.
August 2023
main22460
Stable
Updated and certified against the current SnapLogic Platform release.
May 2023
main21015
Stable
Upgraded with the latest SnapLogic Platform release.
February 2023
main19844
Stable
Upgraded with the latest SnapLogic Platform release.
November 2022
main18944
Stable
Upgraded with the latest SnapLogic Platform release.
October 2022
430patches18173
Latest
The Reltio Snaps which previously hung when there was no data or while processing the data will now time out when there is a slow server response.
August 2022
main17386
Stable
Upgraded with the latest SnapLogic Platform release.
4.29
main15993
Stable
Upgraded with the latest SnapLogic Platform release.
4.28
main14627
Stable
Upgraded with the latest SnapLogic Platform release.
4.27 Patch
427patches12999
Latest
Enhanced the Reltio Generic Execute with a new field Empty Responses as Separate Documents, that enables the Snap to write empty responses as separate documents.
4.27
main12833
Stable
Upgraded with the latest SnapLogic Platform release.
4.26
main11181
Stable
Upgraded with the latest SnapLogic Platform release.
4.25 Patch
425patches10410
Latest
Fixed an issue with the Reltio Create Snap where the Snap processes a lesser number of documents while loading data into Reltio.
4.25
main9554
Stable
Upgraded with the latest SnapLogic Platform release.
4.24
main8556
Stable
Upgraded with the latest SnapLogic Platform release.
4.23
main7430
Stable
Upgraded with the latest SnapLogic Platform release.
4.22
main6403
Stable
Upgraded with the latest SnapLogic Platform release.
4.21
snapsmrc542
Stable
Upgraded with the latest SnapLogic Platform release.
4.20
snapsmrc535
Stable
Upgraded with the latest SnapLogic Platform release.
4.19
snaprsmrc528
Stable
Upgraded with the latest SnapLogic Platform release.
4.18
snapsmrc523
Stable
Upgraded with the latest SnapLogic Platform release.
4.17
ALL7402
Latest
Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.
4.17
snapsmrc515
Latest
Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.
4.16 Patch
reltiosnapconnector6773
Latest
Fixed an issue with the Reltio Generic Execute Snap wherein response codes were handled incorrectly.
4.16
snapsmrc508
Stable
Upgraded with the latest SnapLogic Platform release.
4.15
snapsmrc500
Stable
Upgraded with the latest SnapLogic Platform release.
4.14
snapsmrc490
Stable
New Snap added: Reltio Generic Execute.
4.13 Patch
reltiosnapconnector5200
Latest
Fixed the Reltio Read (Object) Snap to fetch all the records from Reltio objects (entities, categories, and relations, except interactions).
Added two new properties -- "Page Size" and "Records to Read" in the Read (Object) Snap.
4.13
snapsmrc486
Stable
Added a new property, S3 File, to the Reltio Bulk Export Snap to support exporting data to the specified S3 location.
Added new properties Batch size, and Thread limit to the Reltio Delete (URI) and Reltio Delete (Object) Snaps to enhance the performance.
4.12
snapsmrc480
Stable
Introduced the Snap Pack this release. The Snap Pack includes: Reltio Bulk Export, Reltio Create, Reltio Delete (Object), Reltio Delete (URI), Reltio Merge, Reltio Read (CrossWalk), Reltio Read (Object), Reltio Unmerge and Reltio Update.