Connections on Plauti Desktop

Manage your Connections, or add more, via the bottom left menu option Connections.

Prerequisites

• Salesforce: to be able to run jobs for Plauti Deduplicate on a Salesforce Org, make sure that you have access to all of Plauti Deduplicate's Apex classes, for example by use of the Plauti Deduplicate permission set. See Plauti Desktop permissions for Plauti Deduplicate.

Creating a Connection

To create a new Connection to a Salesforce Org or Dynamics 365 Environment:

1. For Salesforce Orgs (both Production and Sandbox), first install the Plauti External Connection App (ECA) in the Org. Read more in Installing the ECA for Salesforce Connections. Then return here for the next steps.
   MS Dynamics Environments do not need to have the ECA installed.
2. In Plauti Desktop, at bottom left, click Connections.
3. In the Connections menu, click + New Connection top right.
4. Click
   • Salesforce Production or Salesforce Sandbox to connect with a Salesforce Production or Sandbox Org, or
   • Dynamics 365 to connect with a Microsoft Dynamics 365 Environment.
     Select the environment type in the select list that appears below. If you do not know your environment type, it most likely is 'Public Cloud (Default)'.
5. Click Connect.
   
6. A Login window pops up. Enter your login data for the Salesforce Org or Dynamics 365 environment you want to connect to.
   • Note that for some Salesforce Sandbox Orgs you might need to use the 'Use Custom Domain' option bottom right.
     • If you are connecting to Salesforce and you get an 'OAUTH_EC_APP_NOT_FOUND' login error, the ECA needs to be installed first. Proceed in Installing the ECA for Salesforce Connections, then return here.
7. For Dynamics 365, select the environment you want to connect to.
8. If prompted, agree to the terms of the Data Processing Agreement and click Proceed.
   

Your team is now connected to your Salesforce Org or Dynamics 365 Environment.

Managing Connections

Connections Overview

At bottom left, click Connections to access the Connections overview. Here you see all current Connections, and their information such as when they were created, whether they are active or inactive, etc.

The username at "On behalf of..." indicates the user that created the Connection. This user will also be displayed as the user who started a job for example.

Connection Details

Click on a Connection to see its details, such as the type of connection, and the Org ID or environment ID. At top right you also have a few managing options.

Edit	Edit the name of the connection and add a description, to quickly see which connection it concerns.
Pause	Temporarily deactivate the connection. A paused connection will no longer retrieve jobs from Salesforce or Dynamics 365. After pausing, the job history for the connection is still available.
Activate	Re-activate the connection to start retrieving jobs again.
Delete	Delete the connection. After deletion, the job history for the connection will stay available.

Re-authorizing a Connection

Connections can expire, for example when tokens are retracted or the DPA needs to be re-signed. This is indicated for each Connection in the Connections overview: the Connection is marked as 'Connection inactive'.

Solve the issue, for example by clicking 'Click here' to accept an updated DPA, or create a new Connection for the Org or environment. This will also re-activate any scheduled jobs that were on Holding due to the inactivity. If you create a new Connection for your Org or environment, the same settings as for the previous Connection will be used.

The Job History for inactive, expired Connections will stay available.