Configure Data Mapping
Important: Nintex eSign is no longer available to download through the Salesforce AppExchange and is no longer supported in Salesforce Lightning. It is recommended to use Nintex DocGen for use with Salesforce Lightning.
In order for information entered by signers to pass from Jotblocks to Salesforce or from Salesforce to pre-fill signer Jotblocks, Nintex eSign Data Mapping must be configured.
Nintex eSign provides support for bi-directional data mapping. This allows:
-
Use of data from Salesforce entity fields to automatically populate the sender inputs for an Nintex eSign template.
-
Use of signer provided data from an Nintex eSign envelope to update fields on a Salesforce entity after signing is complete.
Navigating To The Item Data Mapping For AssureSign For Salesforce Lightning
First, regardless of the direction of dataflow, you will need to navigate to the Nintex eSign Data Mapping Object in Salesforce.
In Salesforce, click the App Menu and search for Nintex eSign Data Mapping. Then, click Nintex eSign Data Mapping under Items.
Next, choose if you are Mapping Data from Fields on a Salesforce Entity to Sender Inputs on a Template or Mapping Data Entered by a Signer to Fields on a Salesforce Entity.
First, select the Salesforce entity from the list on the Nintex eSignData Mapping item that you want to populate data from, such as Account:
Next, scroll down and identify the field you wish to use, and copy its tag. As an example, the tag for the Salesforce field "Account Name" would be "Account.Name":
Next, edit your Simple Setup template in Nintex eSign, and click Edit Sender Input in the upper right of the template:
On the view that appears, enter a name that reflects the information that will be imported from Salesforce:
Set this sender input to required or not required depending on your needs.
Next, click the Advanced tab in the same view and add the Salesforce tag to the tag line:
Finally, click Save Sender Input.
Next, if you wish for the information from Salesforce to prefill a jotblock, you would add a merge field with the newly created sender input to the related Jotblock in the Enter the text to prefill the jotblock blank by selecting the blue circle at the end of the line and then select the appropriate sender input name:
Finally, click Save Jotblock.
First, select the Salesforce entity from the list on the Nintex eSign Data Mapping item that you want to populate data from, such as Account.
Next, scroll down and identify the field you wish to use, and copy its tag. As an example, the tag for the Salesforce field "Account Name" would be "Account.Name".
Next, in Nintex eSign, navigate to your template, and click edit on the jotblock that you want to use to send information to the Salesforce field.
On the Tag line, add the tag you created in the prior step.
Click Save Jotblock.
Ensure your Webhook attached to the template is set to Update Salesforce.
If you haven't already, follow the steps in Configuring DocumentTRAK updates for Nintex eSign for Salesforce Lightning to configure a webhook to use with Nintex eSign for Salesforce Lightning and attach it to your template. In order for information to pass from signer inputs back to Salesforce, Update Data must be turned on in the Webhook.