Install the Reltio Integration for Salesforce

Learn how to install the Reltio Integration for Salesforce managed package.

To install the Reltio Integration for Salesforce, do the following tasks.

You can navigate to Salesforce AppExchange in different ways.

While accessing the AppExchange , you can log in to browser Salesforce AppExchange page. Also you can login to http://login.salesforce.com and open AppExchange page in modal window.

Navigate to AppExchange.
1. In your organization, go to Setup.
2. In the Search box, type AppExchange.
or
1. If you are in AppExchange already, in the upper-left corner select the AppExchange link.
See the following image for AppExchange.
In the Search box, type Reltio Integration for Salesforce.
On the upper-right corner, select Get it Now.
The following Log in to AppExchange image will appear.
Log in to AppExchange.
Select Allow.
You will get the access to the AppExchange.
Select Org to install.
This helps you to install the organization.
Note: Before you install in a production environment, you need to test in a Sandbox.
Install the Reltio Connected Data for Salesforce.
Select Confirm and Install.
Select Install with Admins Only.
Install the Reltio Connected Data for Salesforce.
You can start the installation now.
Note: The option deploys the package contents into the Salesforce organization. The Install with Admins Only option enables you to proceed with the configuration of the connector.

Configuring the Remote Site Settings

In the Salesforce Org, open Setup.
Go to Security > Remote Site settings.
In the Salesforce Org, add the Uniform Resource Identifier (URI) for the configuration.
From Salesforce Org, give access to the URIs.

To configure remote settings, use the list of URIs listed in Table 1: API URIs.

Table 1. API URIs
URIs of the API	Description
https://auth.reltio.com	Defines the Set Auth service, which is used by the Salesforce Connector. This service must be called at least with an auth header.
https://env.reltio.com	Defines URI for tenant environment where the env is the name of the tenant environment.
https://gus-ssrv-sfdc-integration.reltio.com https://361-ssrv-sfdc-integration.reltio.com(in case the AWS only required)	Defines the Reltio Integration for Salesforce URI.
https://prod-sfdc-sbc-api.reltio.com/healthcheck	Defines the API URI for SFDC Search Before Create (SBC).

You can create a Reltio Integration for Salesforce profile. Setting up the Reltio Integration for Salesforce is a one-time activity.

Note: The Reltio Integration for Salesforce profile consists of the following configurations for your Salesforce Organization:

Salesforce organization and Reltio tenant credentials
Mapping of objects, fields, filters and custom logic
Batch size of API messages and frequency of synchronization from Salesforce to Reltio.

You can define a specific connector instance based on cloud location(Amazon Web Services (AWS) or Google Cloud Platform (GCP)).

Run the following steps to identify a particular connector instance:

Select Edit.

The Edit Reltio Sync Settings page will help you to identify the Connector Environment. You can set the values as following:

On the Edit Reltio Sync Settings page, add the following credentials:

Table 2. Credentials for Edit Reltio Sync Settings
Credentials	Description
Auth URL	Defines the authorized URL. For example, https://auth.reltio.com.
Connector Environment	Defines the environment of the connector. You have several connectors with different auth(s). For example, gus, 361. Note: The environment changes have to be done before profile installation. You cannot change the environment after saving the Connector profile or requests to remove the previous profile using the support ticket.
Connector Name	Defines the name of the connector. For example, sfdc-integration.

After you have installed the application for the first time, do the following activities.

Open app launcher.
Select Reltio Integration for Salesforce.
Enter the credentials for Reltio Connected Cloud.
The Reltio Client ID and Reltio Client Secret, along with the Reltio Tenant ID and Reltio Tenant environment. To create a new client, see topic Add new client.
Select Verify.
To check if the credentials are correct.
Note: You can establish a connection between Salesforce and Reltio.

Select Next.

To connect data between Salesforce and Reltio, see the credentials listed in Table 2: Credentials for Reltio Cloud.

Table 3. Credentials for Reltio Cloud
Credentials	Description
Reltio Client ID	Identifier of the client used for synchronization. To create a new client, see topic Add new client.
Reltio Client Secret	The secret of the client.
Reltio tenant ID	Identifier of the tenant, for example `ddHXrrrotBeNhNO`.
Reltio tenant environment	This is the URL prefix of your Tenant URL. For example, if your tenant URL is `https://tst-01.reltio.com/ui/ddHXrrrotBeNhNO`, this indicates that your tenant environment is `tst-01`.

For Salesforce Service User, enter the credentials.
Select Verify.
This helps you to check if the credentials are correct.
Select Next.
The Default Mappings image appears as follows.
You may get an error about a missing or incorrect configuration in Remote Site Setting. For more information, see Remote Site Settings.
Select Default Mapping.
This helps you to to view the out-of-the-box mapping of Salesforce and Reltio objects. The mappings depends on the accelerator you have configured in your Reltio tenant as well as on the Salesforce application.
Select Sync Config to synchronize all the settings with Reltio.
Select Finish to complete the setup.
The values can be edited using the Reltio Control Panel tab available in the Reltio Integration for Salesforce for Salesforce App.
In the Reltio Control Panel, navigate to Trigger Settings.
Select Generate Triggers.
As the Salesforce platform doesn't create the triggers automatically, you must create them manually.
Select Create triggers manually.
Use the source code of the Account and Contact triggers, in the table, and follow the steps in this Salesforce guide.