Settings
You must configure post-installation settings explained in this section, within your account.
eSignature Buttons for the Agreement and Quote/Proposal Object
To initiate the DocuSign signature process and later check the signature status, you must have the correct buttons available on the agreement and quote record object.
The fields may already be available on the default page layouts, so you would only need to complete the following for custom layouts.
From Setup, go to and click Edit for the page layout you want to use with DocuSign eSignatures. Go to the Fields list, and drag the following fields onto the page:
- Send For eSignature (Apttus_CMDSign.SendForESignature)
- Check eSignature Status (Apttus_CMDSign.CheckESignatureStatus)
- Recall E-Signature Request (Apttus_CMDSign. RecallESignatureRequest)
- Correct E-Signature Document (Apttus_CMDSign.ViewESignatureDocument)
From Setup, go to and click Edit for the page layout you want to use with DocuSign eSignatures. Go to the Fields list, and drag the following fields onto the page:
- Send For eSignature (Apttus_QPSign.SendForESignature)
- Check eSignature Status (Apttus_QPSign.CheckESignatureStatus)
- Recall E-Signature Request(Apttus_QPSign.RecallESignatureRequest)
- Correct E-Signature Document (Apttus_QPSign.ViewESignatureDocument)
Server Configuration
Both System Properties and Remote Site Settings must be configured. Initially, you can use a sandbox or demo server to test your DocuSign Services implementation and once you are ready to go live you can switch over to a production server. These two system properties handle that requirement.
|
|
|
|
Name |
Description |
|
Production Server Pod |
Indicates which server the DocuSign Services integration points to, either DEMO server when using a sandbox account or PRODUCTION server when using a production account. This setting is dependent on the Production Environment? setting. That setting indicates whether it's production or development, while this setting specifies the actual name of the server. You can now specify the value in the following format: https://<instance-name>.docusign.net/restapi/v2/ |
|
Production Environment? |
Checking this indicates that the DocuSign production server is to be used. If it is not checked a development/sandbox server will be used. If it is unchecked it will connect to a DEMO server, regardless of what value is in Production Server Pod. |
If the settings mentioned below do not already exist, you must create three Remote Site Settings in the table below. After being set up, these settings need not be changed. Enter the Name, the corresponding URL, and ensure they are Active.
|
|
|
|
Remote Site Name |
Remote Site URL |
|
DemoDocuSign |
|
|
ProdDocuSign |
|
|
Instance URL |
URL of your Salesforce instance |
Changing Document Options
These properties are used to control how you want to work with the documents that are sent for eSignature.
|
|
|
|
Name |
Description |
|
MaxNumberOfSignerRole (Deprecated) |
This sets the maximum number of Signer role fields that will be available. |
|
RetrieveAsCombinedDocument |
Selecting this option generates a single PDF document containing all documents that were signed during the eSignature process. If this is not checked, each document will result in a separate PDF. |
|
In-Person Signers |
This indicates that a signer is in the same physical location as a DocuSign user who will act as the signing host for the document signing. This recipient type can only be used if enabled for the DocuSign account associated with the Org. This must be selected to have the option available from the Signer Type list when selecting recipients. The In-person Signer passes control to a Docusign user who can sign on their behalf. |
Setting Default Recipient Properties
You can now configure default recipients who receive the agreement or contract for signature. The Default Recipients cannot be deleted from the Recipient List. The following managed properties control the behavior of default recipients.
|
|
||
|
Property |
Description |
Behavior |
|
Auto Select Recipient Field |
Allows you to specify a contact field that will be used as default recipient for the eSignature. Note: If the field name is specified, then one recipient from the specified field is auto-selected. For a given implementation and application, either this option or auto-select multiple recipient option should be selected. If both are selected, then auto-select multiple recipient option will take precedence over the one recipient option. |
If this option is selected, The default recipient from the contact field is displayed on the eSignature envelope. This field requires the API name of a field containing the recipient you would like to have auto-selected when sending a document for eSignature. You must ensure this user has an email address, as you cannot edit them once they have been added. For instance, you can enter Apttus_Proposal__Primary_Contact__c or Apttus__Primary_Contact__c to have the primary contact on the proposal or agreement record added automatically as a recipient. You should then ensure the agreement record has a valid user with an email address in that field. The Recipient's field becomes a read-only field once an eSignature request is initiated. When Auto-Select Attachment is not selected, the user is redirected to the Select Attachment screen. |
|
If this option is not selected, you can select recipients while initiating an eSignature request. |
||
|
Auto-Select multiple recipients? |
Allows projects to specify a list of recipients that will have defaulted for the eSignature. To use this option, add DocuSign Recipients related list on the agreement or quote and specify the list for each agreement or quote. |
If this option is selected, the default recipient from the DocuSign Recipients related list is fetched and populated on the eSignature envelope. |
|
If this option is not selected, you can select recipients when an eSignature request is initiated. |
||
|
Auto-Select Attachment |
This property allows you to auto-select the latest modified attachment from the parent document. |
If set to true, The system will auto-select the latest modified document. The system will show the Read-Only selection on the Preview screen.
Specify the following validation message:
Note:
This option is overridden by Select First Document Default setting in System Properties. The system will consider Select First Document Default setting first. |
Configuring DocuSign Custom Classes
- Go to .
- Click Manage.
- Click New to create new custom class.
- Enter the Name of custom class.
- In the Add Recipient Tabs Callback Class field, enter the name of the Callback class to be used for adding a recipient. For example, DocuSignEnvelopeSetRecipientTabs2Imp
- In the Return Recipient Tabs Callback Class field, enter the name of the Callback class to be used for returning a recipient. For example, DocuSignEnvelopeGetRecipientTabs2Imp
- Click Save.
DocuSign System Properties
This section describes the managed properties that are used throughout this document.
Configuring DocuSign System Properties
Configuring Proposal Workflow in DocuSign System Properties
Configuring Contract Management Workflow in DocuSign System Properties
Comply System Properties
The Comply System Properties are used to control the System Properties pertaining to an agreement or contract.
Configuring Comply System Properties
Proposal System Properties
The Proposal System Properties are used to control the System Properties pertaining to the Quote/Proposal.
Configuring Proposal System Properties
Webhook Configuration
To configure the Webhook for DocuSign settings, you must add the settings to both the DocuSign Account and your Salesforce organization.
Configuring DocuSign account
- Login to your DocuSign account.
- Navigate to Admin. In the options menu on the left under Integrations, click Connect.
- Click the Add Configuration and select Salesforce from the dropdown.
- In the popup menu, follow the steps to choose your SOAP Web Services API Version and Environment, then input your Salesforce Username, Password, and Security Token.
Once your Salesforce account is configured, enable the following settings:
System Settings
- Enable Log {maximum 100}
- Require Acknowledgement
- Use Content Files
Associated Users
All Users
Connect Objects
Click New Object, give it the Object Name "DocuSign Envelope Recipient Status" and select DocuSign Envelope Recipient Status from the Select Salesforce Object dropdown.
Add the following values:
|
Docusign Field |
Salesforce Field |
|---|---|
|
Select Where | |
| Envelope ID | DocuSign Envelope Id (Upper) (string) |
| Recipient Email | Email ( email ) |
| Update Fields | |
|
Recipient Status |
Webhook Status ( string ) |
Click New Object, give it the Object Name "DocuSign Envelope Status Object" and select DocuSign Envelope Status Object from the Select Salesforce Object dropdown.
Add the following values:
| DocuSign Field | Salesforce Field |
| Select Where | |
| Envelope ID | Docusign Envelope Id (Upper) (String) |
| Update Field | |
| Recipient Status | Webhook Status (string) |
Trigger Events - Envelope Events:
-
Envelope Voided
Trigger Events - Recipient Events:
- Recipient Signed/Completed
- Recipient Declined
<sfconfig xmlns="http://www.docusign.net/EnvelopeIntegration">
<dsevents>
<dsevent event="Voided" level="Envelope"/>
<dsevent event="Completed" level="Recipient"/>
<dsevent event="Declined" level="Recipient"/>
</dsevents>
<sfobject object="Apttus_DocuApi__DocuSignEnvelopeRecipientStatus__c" objectName="DocuSign Envelope Recipient Status" active="1" insert="0" oncompleteonly="0">
<updatefield sffield="Apttus_DocuApi__WebhookStatus__c" dsnode="Recipient" dsattr="Status" dslink="0" sffolder=""/>
<selectfield sffield="Apttus_DocuApi__Email__c" dsnode="Recipient" dsattr="Email" sffolder=""/>
<selectfield sffield="Apttus_DocuApi__DocusignUpperEnvelopeId__c" dsnode="Envelope" dsattr="EnvelopeId" dslink="0" sffolder=""/>
</sfobject>
<sfobject object="Apttus_DocuApi__DocuSignEnvelopeRecipientStatus__c" objectName="DocuSign Envelope Status" active="1" insert="0" oncompleteonly="0">
<updatefield sffield="Apttus_DocuApi__WebhookStatus__c" dsnode="Envelope" dsattr="Status" dslink="0" sffolder=""/>
<selectfield sffield="Apttus_DocuApi__DocusignUpperEnvelopeId__c" dsnode="Envelope" dsattr="EnvelopeId" sffolder=""/>
</sfobject>
</sfconfig>Click Upload for your Salesforce account and upload the XML file. This creates and configures DocuSign Envelope Recipient Status object and DocuSign Envelope Status object in the Salesforce account.
Configuring in Salesforce
- Navigate to .
- Click Manage.
- Click Edit for System Properties.
- Enable the Docusign Webhook Enabled.
- Click Save.
