Linking a Sandbox org to your DC license

Last published at: July 19th, 2024
Delete

DC Sandbox licenses

Duplicate Check offers free sandbox licenses for your sandboxes. DC Advanced offers 5 licenses, and DC Premium offers 10. If you are using PDM, please contact Plauti Support if you need more than 10 sandbox licenses.
No Duplicate Check license yet? Apply for a free 14-day trial.

Every paid Duplicate Check subscription comes with complementary sandbox licenses for testing purposes. You can link one or more sandboxes via Plauti Cloud, or with our Salesforce SFDX Plugin. Linking via the SFDX Plugin is explained in the readme for the SFDX Plugins‍, section "Link a Sandbox org to Production".

If you are using more Plauti apps in your Sandbox org, they will be linked to your Production license as well.

Linking a Sandbox to your DC license

Linking a Sandbox to your Duplicate Check license via Plauti Cloud‍ is done in a few simple steps:

  1. Go to Plauti Cloud Sandbox Linking.
  2. Log in with your Salesforce Production org login data.
  3. Log in with the Salesforce Sandbox org login data.
  4. Click Link Licenses.
  5. In your Sandbox' DC Setup, refresh the license. Refresh in other Plauti apps as well.

These steps are explained in more detail below.

Delete

When you refresh a sandbox, its ORG ID changes and the link with your production license is lost. Please follow the steps in this instruction again after refreshing your sandbox.


1. Go to Plauti Cloud Sandbox Linking

  1. To access the Plauti Cloud Sandbox Linking page, go to https://cloud.plauti.com/sandboxlinking.
    The Sandbox Linking page opens.


2. Log into your Production org

  1. At left, in the "Step 1 - Log in to Production" section, click Log in to Production.



  2. In the Salesforce login window that appears, enter the login data of your Salesforce Production org and click Log In.



  3. In the pop-up that appears, click Allow to allow the Plauti Cloud Sandbox Linking service access.

Your Production org is now logged on. You can always log out again by clicking "Log Out".


3. Log into your Sandbox org

  1. At right, in the "Step 2 - Log in to Sandbox" section, click Log in to Sandbox.


  2. In the Salesforce login window that appears, enter the login data of your Salesforce Sandbox org and click Log In to Sandbox.



  3. In the pop-up that appears, click Allow to allow the Plauti Cloud Sandbox Linking service access.

Your Sandbox org is now logged on. You can always log out again by clicking "Log Out".
Note that the two Orgs are not yet linked at this stage!


  1. At the bottom of the page, click Link Licenses  .

The Sandbox org is now linked to your Production org. At the top of the page, a green confirmation message appears.


At right, in the Sandbox section, the licenses of your Production org are shown.

  Don't forget the next step: refresh the license in your Sandbox org.


Don't forget the next step: refresh the license in your Sandbox org.


5. Refresh the license

  1. In the linked Sandbox org, go to DC Setup > License. At top right, click Refresh LicenseRefresh License button.

The Sandbox org now uses your Duplicate Check license. If you are using more Plauti apps in your Sandbox, refresh their licenses as well.

 Repeat if you want to link multiple Sandbox connections.

Unlinking a license

To unlink a Sandbox org from your production license:

  1. Repeat steps 1-3 above. 
  2. In step 4, at the bottom of the page, click Unlink Licenses  .
  3. In the unlinked Sandbox org, go to DC Setup > License. 
  4. At top right, click Refresh LicenseRefresh License button.

The Sandbox org now no longer uses your Duplicate Check license.

Managing your Sandbox licenses

To check which Sandbox orgs are currently linked to which Production org(s):

  1. Log into Plauti Cloud.
  2. At left, go to Licenses > Link Licenses.
  3. At top right, select the Production org you want to check.

The list of Sandboxes that are currently linked to the selected Production org appears.

Read more about using Plauti Cloud in Using Plauti Cloud.

Delete

Custom Field error when linking Sandbox license

When linking or having linked a sandbox to your Duplicate Check license, you might get an error stating

"Custom Field *** is configured in a scenario, but custom fields are not licensed."

To solve this, perform a hard license refresh in the Sandbox. Execute the following code in Developer Console > Debug > Open Execute Anonymous Window:

Database.executeBatch(new dupcheck.dc3LicenseBatch());