About Adobe Sign Connector and Sample:

A single oap for module and demo. Calls are via REST API for connectivity with Adobe eSign for sending documents for signature and list of documents available through templates - authored by Phil Bartholo.

How-to Guide:

To use the OutSystems Adobe Sign Connector and Sample Application you will need an Adobe Sign account with privileges using the Adobe Sign API.

1. Sign up for a developer account with Adobe Sign and verify the email address by clicking on the email you receive from Adobe.

https://www.adobe.com/sign/developer-form.html

2. Ensure you have access to the API Applications dashboard. If you sign up with your corporate email address rather than a free service like gmail or yahoo mail, you should be granted a trial with developer permissions. If you find you do not have such access, contact Adobe Support to upgrade your account as necessary.

https://secure.eu2.adobesign.com/account/accountSettingsPage#pageId::API_INFORMATION

3. Add a new application

4. Name the application and select the “Customer” domain

5. Configure OAuth for the application by entering the redirect URI with your own OutSystems URL. Also, check to enable all the capabilities while keeping the modifiers set to “account”. Take note of the Client ID and client Secret assigned to your application as you will need it later.

6. Click the API link on the dashboard and click on the “Oauth Tokens” link in the body

7. Scroll to the example URL and get the protocol and hostname portion of the URL. In the image below, it would be “https://secure.eu2.adobesign.com”. Note this as you will use it when asked for the base URL.  

8. In Service Center -> Factory -> Modules -> AdobeSignConnector -> Site Properties set the site properties as follows:

• AdobeBaseURL: Step 7

• AdobeOAuthURL: https://{AdobeBaseURL}/public/oauth/v2

• ClientID: Step 5 (at Configure OAuth for Application)

• ClientSecret: Step 5

• PlatformServerRootURL: Your Outsystems URL

• RedirectURL: https://{PlatformServerRootURL}/AdobeSignConnector/Documents

• Scope: “user_login:self+agreement_write:account+agreement_send:account+library_read:self+agreement_read:account” 

9. In Service Center -> Factory -> Modules -> AdobeSignConnector -> Integrations set the site properties as follows:

Note: Follow this guide to enable Sign Authentication: https://helpx.adobe.com/sign/using/adobesign-authentication-adobe-sign.html 

Now on the Adobe e-sign platform to create a template for sending a signature:

Select “Create a Library Template”

Give the template a name and drag any PDF file into the “Drag & Drop Files Here” area

Select “Preview & Add Fields” and drag and drop any Signature Fields or Signer Info Fields widgets into the document at the desired location.

Conclusion

The OutSystems Adobe Sign Connector and Sample is now configured to authenticate the user with an Adobe Sign account, present a list of documents, send a document for signature, and get status of the signature.

This can serve as a sample to integrate the same use cases in your own application using the OutSystems configuration, web services, and actions defined in this module. There are additional features and use cases provided by Adobe that can also be leveraged by implementing other portions of the Adobe Sign API.

Next Steps:

If you would like to contribute to this component, here are some suggested additional features:

• Implement session expiration logic to refresh API token

• Implement webhook callback functionality to receive events such as signature captured

• Implement support for document workflow and multi signature documents

• ODC compatibility