DocuSign eSign Request activity

Display Name

Function:

Specifies the activity name that shows in your process.

Accepted Values:

One line of text that can have spaces.

Default Value:

None

Accepts Process Data Variables:

No

Example:

This is a common configuration field that is used in many examples. Refer to:

• Examples - Step-by-step use case examples, information about what types of examples are provided in the AgilePoint NX Product Documentation, and other resources where you can find more examples.

Description

Function:

Specifies an optional text description for your activity.

Accepted Values:

More than one line of text.

Default Value:

None

Accepts Process Data Variables:

No

Amazon S3

Function:

Specifies that Amazon S3 is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > Amazon S3.

Box

Function:

Specifies that Box is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > Box.

Dropbox

Function:

Specifies that Dropbox is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > Dropbox.

File System

Function:

Specifies that the file system on the AgilePoint Server machine is the data source for the file.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > File System.

FTP

Function:

Specifies that FTP is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > FTP.

Google Drive

Function:

Specifies that Google Drive is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > Google Drive.

NetSuite

Function:

Specifies that NetSuite is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > NetSuite.

OneDrive

Function:

Specifies that OneDrive is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > OneDrive.

OneDrive for Business

Function:

Specifies that OneDrive for Business is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > OneDrive for Business.

Salesforce

Function:

Specifies that Salesforce is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > Salesforce.

SFTP

Function:

Specifies that SFTP is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > SFTP.

SharePoint

Function:

Specifies that SharePoint is the source location for your files.

To select your file in the source location, complete the fields on DocuSign eSign Request > Source Repository > SharePoint.

DocuSign

Function:

Specifies the access token that connects to your DocuSign application.

Accepted Values:

A list of access tokens configured for your environment.

Default Value:

None

Accepts Process Data Variables:

No

Create

Opens this Screen:

Access Token for DocuSign

Function of this Screen:

Configure an access token to connect to DocuSign.

Authentication URL

Function:

Shows the URL to connect to the DocuSign site for authentication.

Accepted Values:

Read only.

When you select the access token from Digital Signature field, this field completes.

Default Value:

None

Document Name

Function:

Specifies the name of the document to be signed.

Accepted Values:

A valid document name.

Default Value:

None

Accepts Process Data Variables:

Yes

Send On Behalf Of Below User

Function:

Lets you send a DocuSign document in the name of a user registerd in DocuSign.

To use this option, the DocuSign administrator must enable the permissions for Send On Behalf of Rights in the DocuSign account preferences.

Accepted Values:

• Selected - Lets you send a DocuSign document on behalf of the specified user. To use this option, the value must be an e-mail address registered in DocuSign.
• Deselected - The specified user can send a DocuSign document.

Default Value:

Deselected

Accepts Process Data Variables:

No

Name

Function:

Specifies the name of the sender.

Accepted Values:

A valid user name.

Default Value:

None

Accepts Process Data Variables:

Yes

Email Address

Function:

Specifies the e-mail address of the sender.

Accepted Values:

One line of text (a string) in email address format.

If you use process data variables, domain\username is changed automatically to a valid email format.

If you select Send on behalf of below user, you must enter a valid DocuSign registered e-mail address in this field.

Default Value:

None

Accepts Process Data Variables:

Yes

Subject

Function:

Specifies the subject line for your email.

Accepted Values:

One line of text that can have spaces.

Default Value:

None

Accepts Process Data Variables:

Yes

Example:

${ActivityName} in ${ProcessName} is complete

Also refer to:

• The videos on this page
• (Example) Configure an Email Activity (Notify Requester If Requested Hours Not Available)
• (Example) Configure an Email Activity (Notify Requester - On Manager Approval)
• (Example) Configure an Email Activity (Notify Requester - On Manager Rejection)

Message Body

Function:

Specifies the content of your email.

Accepted Values:

More than one line of text.

Default Value:

None

Accepts Process Data Variables:

Yes

Signer Email Addresses

Function:

Specifies the e-mail addresses of the signer.

Accepted Values:

A list of email addresses, separated by commas (,).

If you use process data variables, domain\username is changed automatically to a valid email format.

Default Value:

None

Accepts Process Data Variables:

Yes

Example:

me@mydomain.com, ${ProcessInitiator}, ${ProcessParticipantUserNames}

CC

Function:

Specifies the recipients in the CC field for your email.

Accepted Values:

A list of email addresses, separated by commas (,).

If you use process data variables, domain\username is changed automatically to a valid email format.

Default Value:

None

Accepts Process Data Variables:

Yes

Example:

• me@mydomain.com
• $MANAGER(DOMAIN\john)
• $MANAGER(${/my:myFields/my:username})

Anchor Text Signing

Function:

Specifies text that shows where the recipient can put signatures, initials and other information in the document.

Accepted Values:

• Include Signature - The sender puts text to search and put the signature and other information in the document.
• Include Initials - The sender puts text to search and put the initials and other information in the document.

Default Value:

Selected.

When you select this field, the Signature Details tab and Initial Details tab becomes available.

Accepts Process Data Variables:

No

Free-Form Signing

Function:

Sends the documents to the recipients without adding tags.

When recipients open documents sent for free-form signing, the recipient sees the Click & Drag box in the document. The recipients can click and apply or drag their signature, initials, and other information on the document to complete the sign.

Accepted Values:

• Selected - The documents are sent to recipients without adding tags.
• Deselected - Anchor Text Signing option is selected.

Default Value:

Deselected

Accepts Process Data Variables:

No

Enable Manual Offset

Function:

Lets you specify the location for the signature or initials with x (horizontal) and y (vertical) coordinates relative to the anchor text in your document.

Accepted Values:

• Selected - Lets you specify the location for the signature or initials with x (horizontal) and y (vertical) coordinates.
• Deselected - Uses the default location for your signature and initials.

Default Value:

Deselected

Signature Flow

Function:

Specifies when the signers must sign the document.

Accepted Values:

• Parallel - The signers can sign the document in parallel with other signers.
• Sequential - The signers must sign the document in the order of the signature workflow.

Default Value:

Parallel

Accepts Process Data Variables:

No

Limitations:

The Signature Flow field is available in these releases:

• AgilePoint NX OnDemand (public cloud)
• AgilePoint NX Private Cloud or AgilePoint NX OnPremises v7.0 Software Update 2 or higher

Signature Anchor String

Function:

Specifies the text string to find and then enter the signature in the document.

Accepted Values:

One line of text that can have spaces.

Default Value:

None

Accepts Process Data Variables:

No

Display document sent date for signature

Function:

Shows the date when the specified document is sent along with the digital signature.

Accepted Values:

• Selected - Shows both the document sent date and the digital signature.
• Deselected - Shows only the digital signature.

Default Value:

Selected

Type

Function:

Specifies the tag type.

Tags identify the places in a document where the recipient can put the signature, initials, or other information.

Accepted Values:

• COMPANY - The recipient's company name shows in the tag.
• EMAIL - The recipient's e-mail address shows in the tag.
• TEXT - The recipient enters text in the tag.
• TITLE - The recipient's title shows in the tag.

Default Value:

TEXT

Name

Function:

Specifies the name of the tag. The name is a unique identifier for the tag.

Accepted Values:

• One line of text that can have spaces.
• A process data variable.

  You can use Process Data screen to specify a process data variable.

Default Value:

None

Limitations:

Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation. It is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business use cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, or other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Value

Function:

Specifies the value of the Name field that shows in the document.

Accepted Values:

• One line of text that can have spaces.
• A process data variable.

Default Value:

None

Limitations:

Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation. It is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business use cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, or other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Add

Function:

Creates a row.

Delete

Function:

Deletes the row.

Initial Anchor String

Function:

Specifies the text string to find and then enter the initial in the document.

Accepted Values:

One line of text that can have spaces.

Default Value:

None

Accepts Process Data Variables:

No

Display document sent date for signature

Function:

Shows the date when the specified document is sent along with the digital signature.

Accepted Values:

• Selected - Shows both the document sent date and the digital signature.
• Deselected - Shows only the digital signature.

Default Value:

Selected

Type

Function:

Specifies the tag type.

Tags identify the places in a document where the recipient can put the signature, initials, or other information.

Accepted Values:

• COMPANY - The recipient's company name shows in the tag.
• EMAIL - The recipient's e-mail address shows in the tag.
• TEXT - The recipient enters text in the tag.
• TITLE - The recipient's title shows in the tag.

Default Value:

TEXT

Name

Function:

Specifies the name of the tag. The name is a unique identifier for the tag.

Accepted Values:

• One line of text that can have spaces.
• A process data variable.

  You can use Process Data screen to specify a process data variable.

Default Value:

None

Limitations:

Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation. It is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business use cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, or other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Value

Function:

Specifies the value of the Name field that shows in the document.

Accepted Values:

• One line of text that can have spaces.
• A process data variable.

Default Value:

None

Limitations:

Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation. It is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business use cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, or other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Add

Function:

Creates a row.

Delete

Function:

Deletes the row.

Document ID

Function:

Specifies a unique ID of the document. This ID comes from DocuSign.

Accepted Values:

A valid document ID.

Default Value:

None

Accepts Process Data Variables:

Yes

Limitations:

Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation. It is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business use cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, or other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Signing URL

Function:

Specifies the process data variable that stores the reference URL for signing the documents.

The reference URL comes in the response from the DocuSign API.

Accepted Values:

A process data variable.

You can use Process Data screen to specify a process data variable.

Default Value:

None

Accepts Process Data Variables:

Yes

Sign Status

Function:

Specifies a process data variable to store the status of the digital signature request.

Accepted Values:

A process data variable.

Default Value:

None

Accepts Process Data Variables:

Yes

Email Sent On

Function:

Specifies the date and time of the digital signature request e-mail.

Accepted Values:

A valid date and time.

Default Value:

None

Accepts Process Data Variables:

Yes