Difference between revisions of "Adobe Sign"

From SmartWiki
Jump to: navigation, search
(Signature Tag Parameters)
(Sequential Signatures)
(42 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
 
==Configuring Global Settings==
 
==Configuring Global Settings==
 +
''Note: In order to use this feature you must request your URL to be whitelisted with development. This can be requested via support ticket.''
  
Go to Global settings - Connectivity section. There should be a section called '''Online Signature Settings'''.  
+
1. Go to Global settings - Integrations section - Service Settings.
  
This allows you to select the e-signature partners, which in this case would be Adobe Sign.  
+
2. Access the option for '''Integration Key Management'''.
  
You are then required to click Save to expose a button labelled Verify Adobe Sign Access.
+
3. Click on New Integration Key. You will be presented with the following fields:
  
When the button is click you can enter your login details for the relevant Adobe Account.
+
* Key Type: set to Adobe Sign
 +
* Key name: Adobe Sign 
 +
* Application ID  (#3): unique Adobe Client ID (from Adobe Sign Account)
 +
* Client Secret (#4): unique Client Secret (from Adobe Sign Account)
 +
* Authentication URL (#5): URL is generic based on your location (from Adobe Sign Account)
  
 +
:: '''To retrieve the above information from your Adobe Sign account:'''
 +
:: 3.1. Login to your Adobe Account
 +
:: 3.2. Go to Account
 +
:: 3.3. To retrieve Client ID and Client Secret:
 +
::: - in Account tab - Adobe Sign API - API Applications (fig. 1)<br />- click on the API Applications record (fig. 1)<br />- click on the link '''Configure OAuth for Application '''(fig. 2)'''<br />'''- copy the Client ID for Application ID (#3)<br />- copy the Client Secret for Client Secret (#4)<br />- make sure Redirect URI included the link for your instance, e.g. https://smart.smartsimple.com/OAuthsp/callback.jsp or https://abcfoundation.smartsimple.com/OAuthsp/callback.jsp<br />- select "self" for the "Enabled Scopes" section, ie. user_login: '''self''', agreement_read: '''self''', agreement_write: '''self''', agreement_send: '''self'''
 +
:: (fig. 1)[[File:adobesecret1.png|thumb|none|800px|Adobe Account Setup.]]
 +
:: (fig. 2)[[File:adobesecret2.png|thumb|none|300px|Adobe Account Setup.]]
 +
:: 3.4. To retrieve Authentication URL:
 +
::: - in Account tab - Account Settings - Account Setup (fig. 3)<br />- check Hostname, e.g. na2.echosign.com or eu1.echosign.com (fig. 3)<br />- use this to construct the Authentication URL (#5), ** only take the region portion, ie. na1, na2, eu1 etc:<br />e.g. Adobe Sign Hostname = '''eu1'''.adobesign.com --> Authentication URL = '''secure.eu1'''.adobesign.com/public/oauth<br />e.g. Adobe Sign Hostname = '''na2'''.documents.adobe.com--> Authentication URL = '''secure.na2'''.adobesign.com/public/oauth <br />(eg. https://secure.adobesign.com/public/oauth or https://secure.na2.adobesign.com/public/oauth or https://secure.eu1.adobesign.com/public/oauth, etc.)
 +
:: (fig. 3)[[File:Adobe2.png|thumb|none|500px|Adobe Account Setup.]]
 +
4. Click Save.<br />
 +
5. Go to Global settings - Integrations section - Service Settings. The '''Online Signature Provider''' section allows you to select the e-signature partners, select '''Adobe Sign'''.<br />
 +
6. Click Save, after page refreshes, under '''Online Signature provider''', click '''Verify Adobe Sign Access'''.<br />
 +
7. A popup will be launched, enter your login details for the relevant Adobe Account and authorize access for SmartSimple.
 
==Configuring the Web Page View==
 
==Configuring the Web Page View==
 
On the {{WPV}} where you wish to enable signing, enable the following two settings:
 
On the {{WPV}} where you wish to enable signing, enable the following two settings:
  
1) Online Signature : This will enable a new button on the {{WPV}} called "Online Signature"
+
1) Online Signature: This will enable a new button on the {{WPV}} called "Online Signature"
:[[Image:Signority-PDFOptions.png|link=]]
 
2) Store-To value : Determines where the finalized PDF document will be stored in the system.
 
:[[Image:Signority-ValueStoresTo.png|link=]]
 
  
 +
: [[Image:Signority-PDFOptions.png|link=]]
 +
2) Store-To value: Determines where the finalized PDF document will be stored in the system.
  
 +
: [[Image:Signority-ValueStoresTo.png|link=]]
 
==Signature Tag Parameters==
 
==Signature Tag Parameters==
The signature tag is used to define the contact details and signing order for the signee.  
+
The signature tag is used to define the contact details and signing order for the signee.
  
* <nowiki>{{*_es_:sender:title}} </nowiki>- name of the sender. Will be the name associated with the Adobe Sign account configured in the Global Settings.  
+
* <nowiki>{{_es_:sender:title}} </nowiki>- name of the sender. Will be the name associated with the Adobe Sign account configured in the Global Settings.
* <nowiki>{{_es_:signer~Index~:signature}}</nowiki> - will automatically add all the signees from the contact list to the web page view as required signatures  
+
* <nowiki>{{_es_:signer1:signatureblock}} </nowiki> - may be used for defining one signature line placement in conjunction with syntax for defining the signee using variable syntax <!--signature @Signee Email@;@Signee Firstname@;@Signee Lastname@;1-->
* <nowiki>{{_es_:signer~Index~:initials}} </nowiki>- will automatically add all the signees initials from the contact list to the web page view
+
* <nowiki>{{_es_:signer~Index~:signature}}</nowiki> - will automatically add all the signees from the contact list to the web page view as required signatures
 +
* <nowiki>{{_es_:signer~Index~:signatureblock}}</nowiki> - will automatically add all the signees from the contact list to the web page view as required signatures
 +
* <nowiki>{{_es_:signer~Index~:initials}} </nowiki>- will automatically add all the signees initials from the contact list to the web page view
 
* <nowiki>{{_es_:signer~Index~:company}} </nowiki>- will automatically add all the signees Company from the contact list to the web page view
 
* <nowiki>{{_es_:signer~Index~:company}} </nowiki>- will automatically add all the signees Company from the contact list to the web page view
 
* <nowiki>{{_es_:signer~Index~:fullname}}</nowiki> - will automatically add all the signees from the contact list to the web page view
 
* <nowiki>{{_es_:signer~Index~:fullname}}</nowiki> - will automatically add all the signees from the contact list to the web page view
* <nowiki>{{_es_:signer~Index~:optsignature}} </nowiki> - will automatically add all the signees from the contact list to the web page view as optional signatures  
+
* <nowiki>{{_es_:signer~Index~:optsignature}} </nowiki> - will automatically add all the signees from the contact list to the web page view as optional signatures
* <nowiki>{{_es_: signer~Index~:optinitials}}</nowiki>:- will automatically add all the signees initials from the contact list to the web page view
+
* <nowiki>{{_es_: signer~Index~:optinitials}}</nowiki>:- will automatically add all the signees initials from the contact list to the web page view
 +
* <nowiki>{{ _es_: signer~Index~:date}}</nowiki>:- will automatically add all the signees' date of signature
 +
 
 +
The Signature tabs are used in conjunction [[List Syntax]] for contacts and with the <!--Signature--> tag appropriate for the signing order. There are 2 tags used depending on the order:
 +
 
 +
* Parallel: <nowiki><!--SignatureFlow P--> </nowiki>
 +
* Sequencial: <nowiki><!--SignatureFlow S--></nowiki>
 +
 
 +
 
 +
==HTML Examples==
 +
Syntax to configure WPV for Adobe Sign is based on the same syntax as Signority except for specific Signature Tag Parameters that Adobe Sign required. For more examples, please refer to the [[Signority Configuration]].
 +
 
 +
===Single Signature===
 +
For single signatures, you can reference custom fields which contain the email, first name and last name of the signee.
 +
In the example below, the recipient has been added as a {{UTA}} contact with the [[UTA role]] of "Signee."
 +
 
 +
{| class="wikitable"
 +
|-
 +
||
 +
<nowiki><!--signature @contact.Signee.email@;@contact.Signee.firstname@;@contact.Signee.lastname@;1--></nowiki><br />
 +
<nowiki><br /></nowiki><nowiki>{{_es_:signer:signatureblock}}</nowiki><nowiki><br /></nowiki><br />Name : @contact.Signee.fullname@<nowiki><br /></nowiki> <br />Title : @contact.Signee.title@ <nowiki><br /></nowiki>
 +
 
 +
|}
 +
 
 +
You can also hard code the parameters, if there is a contact that will always be signing the document.
 +
 
 +
{| class="wikitable"
 +
|-
 +
||
 +
<nowiki><!--signature support@smartsimple.com;SmartSimple;Support;1--></nowiki><br /><nowiki><br /></nowiki><nowiki>{{_es_:signer:signatureblock}}</nowiki><nowiki><br /></nowiki><br />Name : SmartSimple Support<nowiki><br /></nowiki> <br />Title : Support <nowiki><br /></nowiki>
 +
 
 +
|}
 +
 
 +
===Multiple Signatures===
 +
Use the [[List Syntax]] for contacts in conjunction with the Adobe Signature Tag Parameters.
 +
 
 +
====Sequential Signatures====
 +
The order of the signees is determined by the order they appear on the {{WPV}}. If sorting by anything other than by signing number, such as by name, leave the sequence parameter blank as the system will automatically assign a number once submitted.
 +
 
 +
The following example pulls all contacts attached to the {{l1}} with a [[role ID]] of 10991 or 10992, and sorts the contacts by the value of [[Role Based Custom Fields|UTA role field]] 1359726.
 +
 
 +
{| class="wikitable"
 +
|-
 +
||
 +
[#(?object=contact;criteria=(roleid='10991' or roleid='10992');orderby=tbl_1359726.valuestr)<br />
 +
<nowiki><!--signature ~email~;~firstname~;~lastname~;~Index~--></nowiki>
 +
 
 +
<nowiki><br /></nowiki><nowiki>{{_es_:signer~Index~:signature}}</nowiki><nowiki><br /></nowiki><br />
 +
<br />Initials : <nowiki>{{_es_: signer~Index~::optinitials}}</nowiki><nowiki><br /></nowiki><br />Name : ~firstname~ ~lastname~<nowiki><br /></nowiki><br />Title : ~title~<nowiki><br /></nowiki><br />#]
 +
 
 +
|}
 +
 
 +
[[Category:Integration]]
 +
[[Category:External Services]]
 +
[[Category: e-Signature]]

Revision as of 12:17, 15 April 2021

Configuring Global Settings

Note: In order to use this feature you must request your URL to be whitelisted with development. This can be requested via support ticket.

1. Go to Global settings - Integrations section - Service Settings.

2. Access the option for Integration Key Management.

3. Click on New Integration Key. You will be presented with the following fields:

  • Key Type: set to Adobe Sign
  • Key name: Adobe Sign 
  • Application ID  (#3): unique Adobe Client ID (from Adobe Sign Account)
  • Client Secret (#4): unique Client Secret (from Adobe Sign Account)
  • Authentication URL (#5): URL is generic based on your location (from Adobe Sign Account)
To retrieve the above information from your Adobe Sign account:
3.1. Login to your Adobe Account
3.2. Go to Account
3.3. To retrieve Client ID and Client Secret:
- in Account tab - Adobe Sign API - API Applications (fig. 1)
- click on the API Applications record (fig. 1)
- click on the link Configure OAuth for Application (fig. 2)
- copy the Client ID for Application ID (#3)
- copy the Client Secret for Client Secret (#4)
- make sure Redirect URI included the link for your instance, e.g. https://smart.smartsimple.com/OAuthsp/callback.jsp or https://abcfoundation.smartsimple.com/OAuthsp/callback.jsp
- select "self" for the "Enabled Scopes" section, ie. user_login: self, agreement_read: self, agreement_write: self, agreement_send: self
(fig. 1)
Adobe Account Setup.
(fig. 2)
Adobe Account Setup.
3.4. To retrieve Authentication URL:
- in Account tab - Account Settings - Account Setup (fig. 3)
- check Hostname, e.g. na2.echosign.com or eu1.echosign.com (fig. 3)
- use this to construct the Authentication URL (#5), ** only take the region portion, ie. na1, na2, eu1 etc:
e.g. Adobe Sign Hostname = eu1.adobesign.com --> Authentication URL = secure.eu1.adobesign.com/public/oauth
e.g. Adobe Sign Hostname = na2.documents.adobe.com--> Authentication URL = secure.na2.adobesign.com/public/oauth 
(eg. https://secure.adobesign.com/public/oauth or https://secure.na2.adobesign.com/public/oauth or https://secure.eu1.adobesign.com/public/oauth, etc.)
(fig. 3)
Adobe Account Setup.

4. Click Save.
5. Go to Global settings - Integrations section - Service Settings. The Online Signature Provider section allows you to select the e-signature partners, select Adobe Sign.
6. Click Save, after page refreshes, under Online Signature provider, click Verify Adobe Sign Access.
7. A popup will be launched, enter your login details for the relevant Adobe Account and authorize access for SmartSimple.

Configuring the Web Page View

On the Web Page View where you wish to enable signing, enable the following two settings:

1) Online Signature: This will enable a new button on the Web Page View called "Online Signature"

Signority-PDFOptions.png

2) Store-To value: Determines where the finalized PDF document will be stored in the system.

Signority-ValueStoresTo.png

Signature Tag Parameters

The signature tag is used to define the contact details and signing order for the signee.

  • {{_es_:sender:title}} - name of the sender. Will be the name associated with the Adobe Sign account configured in the Global Settings.
  • {{_es_:signer1:signatureblock}} - may be used for defining one signature line placement in conjunction with syntax for defining the signee using variable syntax
  • {{_es_:signer~Index~:signature}} - will automatically add all the signees from the contact list to the web page view as required signatures
  • {{_es_:signer~Index~:signatureblock}} - will automatically add all the signees from the contact list to the web page view as required signatures
  • {{_es_:signer~Index~:initials}} - will automatically add all the signees initials from the contact list to the web page view
  • {{_es_:signer~Index~:company}} - will automatically add all the signees Company from the contact list to the web page view
  • {{_es_:signer~Index~:fullname}} - will automatically add all the signees from the contact list to the web page view
  • {{_es_:signer~Index~:optsignature}} - will automatically add all the signees from the contact list to the web page view as optional signatures
  • {{_es_: signer~Index~:optinitials}}:- will automatically add all the signees initials from the contact list to the web page view
  • {{ _es_: signer~Index~:date}}:- will automatically add all the signees' date of signature

The Signature tabs are used in conjunction List Syntax for contacts and with the tag appropriate for the signing order. There are 2 tags used depending on the order:

  • Parallel: <!--SignatureFlow P-->
  • Sequencial: <!--SignatureFlow S-->


HTML Examples

Syntax to configure WPV for Adobe Sign is based on the same syntax as Signority except for specific Signature Tag Parameters that Adobe Sign required. For more examples, please refer to the Signority Configuration.

Single Signature

For single signatures, you can reference custom fields which contain the email, first name and last name of the signee. In the example below, the recipient has been added as a contact with the UTA role of "Signee."

<!--signature @contact.Signee.email@;@contact.Signee.firstname@;@contact.Signee.lastname@;1-->
<br />{{_es_:signer:signatureblock}}<br />
Name : @contact.Signee.fullname@<br />
Title : @contact.Signee.title@ <br />

You can also hard code the parameters, if there is a contact that will always be signing the document.

<!--signature support@smartsimple.com;SmartSimple;Support;1-->
<br />{{_es_:signer:signatureblock}}<br />
Name : SmartSimple Support<br />
Title : Support <br />

Multiple Signatures

Use the List Syntax for contacts in conjunction with the Adobe Signature Tag Parameters.

Sequential Signatures

The order of the signees is determined by the order they appear on the Web Page View. If sorting by anything other than by signing number, such as by name, leave the sequence parameter blank as the system will automatically assign a number once submitted.

The following example pulls all contacts attached to the Level 1 with a role ID of 10991 or 10992, and sorts the contacts by the value of UTA role field 1359726.

[#(?object=contact;criteria=(roleid='10991' or roleid='10992');orderby=tbl_1359726.valuestr)
<!--signature ~email~;~firstname~;~lastname~;~Index~-->

<br />{{_es_:signer~Index~:signature}}<br />

Initials : {{_es_: signer~Index~::optinitials}}<br />
Name : ~firstname~ ~lastname~<br />
Title : ~title~<br />
#]