On the Salesforce lightning page, navigate to the Adobe Acrobat Sign Admin tab.
- Adobe Acrobat Sign Integrations
- What's New
- Product Versions and Lifecycle
- Acrobat Sign for Salesforce
- Install the Package
- Configure the Package
- User Guide
- Enable Digital Authentication
- Developer Guide
- Advanced Customization Guide
- Field Mapping and Templates Guide
- Mobile App User Guide
- Flows Automation Guide
- Document Builder Guide
- Configure Large Documents
- Upgrade Guide
- Release Notes
- FAQs
- Troubleshooting Guide
- Additional Articles
- Acrobat Sign for Microsoft
- Acrobat Sign for Microsoft 365
- Acrobat Sign for Outlook
- Acrobat Sign for Word/PowerPoint
- Acrobat Sign for Teams
- Acrobat Sign for Microsoft PowerApps and Power Automate
- Acrobat Sign Connector for Microsoft Search
- Acrobat Sign for Microsoft Dynamics
- Acrobat Sign for Microsoft SharePoint
- Overview
- SharePoint On-Prem: Installation Guide
- SharePoint On-Prem: Template Mapping Guide
- SharePoint On-Prem: User Guide
- SharePoint On-Prem: Release Notes
- SharePoint Online: Installation Guide
- SharePoint Online: Template Mapping Guide
- SharePoint Online: User Guide
- SharePoint Online: Web Form Mapping Guide
- SharePoint Online: Release Notes
- Acrobat Sign for Microsoft 365
- Acrobat Sign for ServiceNow
- Acrobat Sign for HR ServiceNow
- Acrobat Sign for SAP SuccessFactors
- Acrobat Sign for Workday
- Acrobat Sign for NetSuite
- Acrobat Sign for SugarCRM
- Acrobat Sign for VeevaVault
- Acrobat Sign for Coupa BSM Suite
- Acrobat Sign for Zapier
- Acrobat Sign Developer Documentation
Are you unable to send agreements from Salesforce? Do data mappings fail to update the Salesforce fields?
Adobe Acrobat Sign for Salesforce: Troubleshooting Guide is designed to help you resolve issues in sending agreements from Salesforce, data mappings, or automatic status updates. See how to:
Acrobat Sign Data Mappings update Salesforce objects when an Acrobat Sign agreement is signed or at a specified stage in the agreement workflow. Each Data Mapping is set up ahead of time and includes data mapping rules. Each data mapping rule defines the data source and the target Salesforce field that it must update. For details, refer to Salesforce Data Mapping.
If data mapping fails to update a Salesforce field, run the following troubleshooting steps to identify and fix the issue:
To do so:
-
Ensure that the automatic status update user (typically the Sign account admin that you used to set up the integration) and that the sender has access to the objects that you're trying to update with Data Mapping.
To check the value of the field, you can add the field to the Agreements list view, use the developer console, or use the Workbench.
Ensure that the ‘Data Mapping Result’ field on the ‘Agreement’ object has the value of either ‘Completed’ or ‘Failed.’ If there is no value, it means that data mapping was not triggered at all. If the value is empty and if the field ‘Data Mapping’ has the user ID populated, try to retrigger data mapping as follows:
The Data Mapping Error field stores errors from data mapping. You can check the value of the field by adding the field to the Agreements list view, using the developer console, or via Workbench. Below is a list of common errors and corresponding resolution steps:
Error | Failed to map data field: System.DmlException Update failed. First exception on row 0 with id 00ZxxqwertasdmjVUAR; first error: STRING_TOO_LONG, Owner Title: data value too large: Adobe Acrobat Sign Adobe inc (max length=20): [Owner_Title__c] (echosign_dev1) 165 |
Resolution: This error means that the data in the form field of the updated document exceeds the size limit of the Salesforce field that you're trying to update. To resolve:
|
|
Error |
Attempted to map to a related object reference which wasn’t set on the agreement: <api name of field on the Salesforce object you are trying to update>” |
Resolution: This error means that there is no connection established between the Agreement object and the Salesforce object that you are trying to update. See step 4 above. |
|
Error |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
Resolution This error denotes that data mapping failed because it couldn’t access a required object. Run the following steps to resolve the error:
|
Example User:
John Smith
Example Use Case:
John wants to:
- Send agreements from a custom object called ‘Demo 1’ using an agreement template,
- Pull information from another custom object called ‘Demo 2’ that is associated with the ‘Demo 1’ object and push to the agreement, and
- Push information to the ‘Demo 2’ object record once the agreement is signed.
Steps to achieve the use case:
- On the Acrobat Sign ‘Agreement’ object, create a lookup field for the 'Demo 1’ object.
- On the ‘Demo 1’ object, create a lookup field for the ‘Demo 2’ object.
You cannot pull or push information from/to a related list. - Create a Data Mapping Template as follows:
- Provide a unique template name.
- Under Fields Mappings, select Selected Object, and then from the dropdown menu, select Demo 1.
- From the second dropdown that loads, select Demo 2 ID.
- In the third dropdown that loads, leave it as ‘None’ and select Select.
- For ‘Which Salesforce Field to Update?’, choose the field name you need to update.
- To complete the data mapping setup, follow the steps under the section Use Data Mappings to push signer data and files to Salesforce records in the Mappings and Templates Guide.
- Create a Merge Mapping Template as follows:
- Provide a unique template name.
- Select Add Field Mapping.
- Under Source Value, select Selected Object, and then from the drop-down menu, select Demo 1.
- From the second dropdown that loads, select Demo 2 ID.
- From the next drop-down that loads, select the field name with the value you need to pull and select Done.
- To complete the Merge mapping setup, follow the section Use Merge Mappings to generate documents with Salesforce data in the Mappings and Templates Guide.
- Create an agreement template by following the steps under Create template workflows.
- In the agreement template you created above, ensure that the merge mapping and data mapping templates are included in the ‘Data mapping’ section.
- On the Template details section of the Agreement template, select the Salesforce object as Demo 1.
- Select Map data into agreement fields and then in the dialog that appears:
- Select the option Select from object.
- Under Source Type, select Demo 1 ID.
- Under Target Agreement Field, select Demo 1 object in the lookup field.
- Select Save.
- On the agreement template, select Save.
It creates an agreement template linked to the ‘Demo 1’ object with merge mapping and data mapping enabled. - Open a ‘Demo 1’ object record, and select > Edit page. Then, from the Custom managed section on the left panel, drag and drop AgreementPanel and select Save.
- Select Activation and assign the record page as per your needs. For testing purposes, choose ‘Assign as Org Default’, which exposes ‘AgreementPanel’ to all users.
- Select Next and Save.
- Navigate to the ‘Demo 1’ object record and refresh the page. It should display the ‘AgreementPanel’ panel that you added.
- Select Send Agreement for Signature. It displays the agreement template that you created.
- Select the agreement template and follow the steps on the screen to send the agreement. Verify that the agreement includes the merged data from ‘Demo 2’.
- Sign the agreement. It shows the ‘Demo 2’ record updated with the value from the agreement.
If you are unbale to send agreements from Salesforce, run the following troubleshooting steps:
-
Ensure that you are on a supported version of Adobe Acrobat Sign. See supported versions.
-
Ensure that you, as a sender, have the required permissions.
See how to grant required access to users. In addition to objects and fields mentioned in the guide, the sender must have access to other Salesforce objects that are being used in the workflow. -
Check if your ‘Agreement’ object or other Acrobat Sign objects in Salesforce have customizations such as triggers, workflows, or rules. If yes, disable all the customizations and send a test agreement to see if it goes through.
If the agreement is successfully sent after disabling the customizations, refer to our developer guide for guidelines.
Note:We do not provide support for troubleshooting customizations.
-
Use one of the following ways to identify the type of error that you received while sending the agreement:
- Open the impacted agreement record in Salesforce and check for a red banner with an error message. This error should indicate the root cause.
- Check the ‘Error Message’ field on the ‘Agreement Notification’ object.
- To check via the Developer Console and execute the following SOQL query:
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<enter agreement id>
-
Refer to the following table of errors and steps to resolve:
Error
Resolution
Invalid user ID or email provided in x-api-user header
OrYou don't have a valid Adobe Acrobat Sign user account
These errors denote that the sender does not have a valid Acrobat Sign license. To troubleshoot:
- Check the Sender Recorded field on the Agreement record to identify the sender of the agreement.
If a user on the Sender Recorded field cannot be found in Salesforce, the Acrobat Sign package will use the Created By field as the ‘sender’ of the agreement. - Navigate to the sender's User details page in Salesforce and ensure that the Email field has a valid email address and an active Sign Enterprise license. To check if the email address has an active Sign Enterprise license.
- Login to Acrobat Sign using admin credentials.
- Navigate to Account > Users and look up the email address.
- The status of the user should be active. Users who don't have an ‘active’ status cannot send agreements. If the user isn't active, see how to Add and manage users and refer to the steps under the section ‘The email is in use, but the user status isn’t Active’.
- If Send on behalf of (SOB) is used, validate the email address by checking the Send on Behalf of field on the Agreement object. Ensure that the email address of this user has a valid Sign license by logging into Acrobat Sign. Ensure that the Allow Sending as Other Users field is enabled on the SOB user’s User details page. This field may not be visible on the User object page layout by default.
- Verify user permissions as mentioned in Step # 2 above. See how to grant required access to users.
File format is not supported
This error occurs when the document you're trying to send for signature isn't in a supported format.
Refer to the Supported document formats section in System Requirements for Acrobat Sign to check which file formats are supported for uploading to Acrobat Sign.
Incorrect Object Id used in signature button
This error occurs when the Send on Behalf Of button's template ID or object's master ID is invalid.
We suggest that you enter the correct object ID and then retry the process.
- Check the Sender Recorded field on the Agreement record to identify the sender of the agreement.
If an agreement does not get updated with the correct status, run the following troubleshooting steps:
-
Verify that you've implemented the prerequisites and the Post-install configurations (Required) mentioned in the Adobe Acrobat Sign for Salesforce: Installation Guide.
-
On the Salesforce lightning page, go to Adobe Acrobat Sign Admin > Enable Automatic Status Updates and ensure that you see the message “Automatic Status Updates are enabled for this organization.”
If you don't see the message, run the following steps:
- Log out and log back in as the System administrator.
- Go to Adobe Acrobat Sign Admin > Enable Automatic Status Updates and select Enable.
- On the ‘Allow access to Acrobat Sign’ dialog that appears:
- Note the email address at the bottom of the dialog.
- Ensure that this email address has a valid Sign license and is a System administrator in Salesforce.
- Ensure that the user has the ‘Adobe Sign Integration User’ permission set assigned.
- Select Allow.
It should display the message ‘Automatic Status Updates are enabled for this organization.’
-
On the ‘Agreement Notification’ object, check the Error Message field. To check the value on the field, execute the below SOQL query on the Developer Console:
SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'
-
If the agreement is a push agreement that was created outside of the Salesforce environment, ensure that you follow the Adobe Acrobat Sign for Salesforce: Large Documents & Push Agreements Service Guide.
-
Check if the status gets updated on those agreements. If they do get updated now, check if the issue is still reproducible with a new test agreement. If it is reproducible, continue with the troubleshooting steps below.
If the issue is not reproducible, it may have been a one-off instance and we suggest that you refer to this troubleshooting guide when the issue re-occurs.
-
Check if your ‘Agreement’ object or other Acrobat Sign objects in Salesforce have customizations such as triggers, workflows, or rules.
If yes, disable all the customizations and send a test agreement following your usual steps and see if it goes through. The status should change from ‘Draft’ to ‘Out for signature’.
If the agreement status changes to 'Out for signature' after disabling the customizations, refer to our developer guide for guidelines.
If the status does not get updated, send a test agreement directly from the ‘Agreements’ tab with customizations disabled and check if it goes through. If the status still doesn't change, check steps #1 and #2 mentioned above.
Note:We do not provide support for troubleshooting customizations.
Acrobat Sign Objects Add File Attachments File Mappings Map Data into Agreement Fields Add Form Field Templates Form Field Imports Merge Mappings Add Recipients Form Field Child Mapping Mutexes Agreements Form Field Child Mapping Entry Object Mappings Agreement Events Form Field Mappings Recipients Agreement Templates Form Field Mapping Entries Signed Agreement Data Mappings Group Mappings Triggers Field Mappings Library Templates User Sync Results Agreement Type
All organizations now have Salesforce's Enhanced domains enabled by default, which does not impact the Acrobat Sign for Salesforce package. However, customers who configured their sites for large file download and push agreements experience issues when their enhanced domains are enabled, resulting in changed site URLs and broken agreements.
To ensure the smooth functioning of agreements, customers need to update the custom settings for large file downloads to reflect the updated site URL.
For updating the Push agreements callback URL, customers must Contact support and provide the required information. For details, see how to Get individual services configured for your Acrobat Sign account.
Acrobat Sign for Salesforce allows you to search for and add leads as agreement recipients when Leads is selected as the recipient type. However, if Government Cloud users create leads, contacts, or users but are not able to find them using the Search field, Saleforce org admins can follow these resolution steps:
- Go to Setup > Object Manager and then search for Lead.
- From the left panel, select Fields & Relationships.
- For all the required fields (such as Name, Email, Mobile, and more), check the acccessibility to the users. To do so:
- Select any field that you want to check. For instance, select Mobile.
- For all the users who you want to enable the field access for, select the Visible checkbox.
- Select Save.
If the issue is not resolved even after following the above troubleshooting steps, Contact support and provide us with the following details:
- Issue description
- Email address of the Acrobat Sign account admin that was used to set up the integration
- Email address of the Acrobat Sign account admin that was used to enable automatic status updates:
- Acrobat Sign package version installed in Salesforce
- Salesforce org ID
- Salesforce records ids of impacted agreements
- Email address of the impacted user
- Is the issue consistently reproducible, intermittent, or one-off?
- Date of latest occurrence: <Provide the date/time/timezone of the last known occurrence>
- Steps to replicate the issue
- Expected behavior: <Describe the behavior that you expect when the steps are performed>
- Troubleshooting notes: <Provide details of troubleshooting done so far with this documentation>