Reltio Generic Execute

Reltio Generic Execute

In this article

Overview

The Reltio Generic Execute Snap allows you to perform Read, Write, Update and Delete operations upon objects in the specified Reltio tenant by executing REST APIs (GET, PUT, POST, and DELETE). The API key that you specify in the Account settings determines the API calls that you can make. 

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 appropriate read and write access to create objects in the Tenant.

Support for Ultra Pipelines  

Works in Ultra Pipelines

Limitations and Known Issues

  • You cannot roll back the productized Reltio Snap Pack in 4.20 to a prior version.

Snap Input and Output

Input/Output

Type of View

Number of views

Examples of upstream/downstream Snaps

Input/Output

Type of View

Number of views

Examples of upstream/downstream Snaps

Input

Document

Min: 0

Max: 1

  • JSON Generator

  • JSON Formatter

Output

Document

Min: 1

Max: 1

  • Mapper 

  • Copy

Snap Settings

Field

Field Type

Description

Field

Field Type

Description

Label*

String

Specify the name for the Snap. Modify this to be more specific, especially if there are more than one of the same Snap in the Pipeline.

Service URL*

String

Specify the service URL in the format: .

The format to be followed:

  • For performing an operation on all objects of an object type: https://www.reltio.com/tenant_id/object_type

  • For performing an operation on specific object in an object type: https://www.reltio.com/tenant_id/object_type/object_id

  • For performing an operation on crosswalks related to an object: https://www.reltio.com/tenant_id/object_type/entity_id/crosswalks

Default Value{tenantUrl}/{serviceUri}
Example{tenantUrl}/{serviceUri}

HTTP Method*

Dropdown list

Select the type of HTTP request.

  • Get

  • Post

  • Put

  • Delete

Default Value: Get 
Example: Post

HTTP Request Body

String

Specify the HTTP body of the request. Relevant to post request.

You can provide this value dynamically as a Pipeline parameter and upstream parameter or directly in the Snap.

Default Value: [None] 

Query parameters

Use this field set to define query parameters and their values. The query parameters are attached to the URL using the HTTP query parameter syntax, separated by & and added as 'key=value'.

You can provide the parameters dynamically as Pipeline parameters or directly in the Snap, but not as upstream values.

Query parameter

String

Specify the name of the query parameter to pass in the API.

Default Value: [None]
Example: type

Query parameter value

String

Specify the value for the specified query parameter.

Default Value: [None]
Example: reltio

Raw data

Checkbox

Select this checkbox to write the HTTP response content to the output view as it is. If you deselect this checkbox, the data is parsed according to content type. 

Default Value: Deselected

Empty Responses as Separate Documents

Checkbox

Select this checkbox to write all responses into separate output documents in the same order as they appear in the request body.

Deselect this checkbox to group all empty responses into one output document.

When you fetch multiple entities with POST {TenantURL}/entities/_byUris, the non-existing entities result in empty-string responses.

Default Value: Deselected

Retry limit

Integer

Specify the maximum number of attempts to get the response. 
Minimum value: 1
Maximum value: 10

Default Value: 5

Snap Execution

Dropdown list