API Method DocuSignCreateCustomEnvelopes is Added to Create Envelop using Template along with Dynamic fields on the document that needs to be filled on run time.
- ClientUserId - It is mandatory to use when using Docusign API using Template.
- RoutingOrder - It can be sued if multiple signers need to sign the Document sequentially.
- Tabs - This field can be used to populate Custom Fields/Data Labels (Dynamic fields) on the Document that needs signing.
Action CreateSendEnvelopesByTemplateV2 is Added to Call DocuSignCreateCustomEnvelopes API Methods
and also a few structures are added as required.
Help on "How to get Key Pair files" after opening the CMD from the previous documentation
Open CMD in the location recommended and run the command “openssl genrsa -aes256 -out my_private_key.pem 2048” and set a password.
Then run the command “openssl rsa -pubout -in my_private_key.pem -out my_public_key.pem” and set the same password.
After that make sure these files are created in your location. You will need them in the Docusign Configurator component and in the DocuSign setting
How to configure Docusign
To configure the OAuth2.0 with JWT for the new Rest Apps, first you need to make sure you have an organization configured on your Docusign developer account. If you don’t, please follow the following steps:
Click on Get Started to create your organization
Give a name to your organization
Link and account
After that you’ll be redirected to your Docusign Admin dashboard.
To configure a new App to integrate with Outsystems follow the steps below:
Go to your Apps and Keys. If you need to switch from your Admin Dashboard to your esignature admin go to Accounts
On your esginature admin dashboard go to Apps and Keys in the Integration section
In here you can already get your UserId and your AccountID. Click on “Add app and integration key”
Give a name to your integration App. Upload a RSA key. If you are using the Docusign Configurator and you have uploaded the file, you can get the Key text from there
If the upload was successful, you will have one RSA Keypair uploaded
In the additional settings, add an URI to your environment. Make sure this uri is the same as you put on the site properties of the component. This URI is only used in the activation url
Click Save and you’ll have your integration configured. Put the Integration Key on the site property of the component.
No go to your Docusign Admin dashboard. Click in the “Switch To” button and click on the Docusign Admin
Select “Connected Apps” and click on “Authorize Application”
Select the app you have created and put the scopes “signature”. It is the scope configured for the component. If you need other scopes you need to edit the component
Follow the rest of the instructions on the Docusign configurator. Don’t forget to access the link given in the configurator in order to activate the user for that app on docusign
How to get Key Pair files
Windows :
Go to http://gnuwin32.sourceforge.net/packages/openssl.htm and download the Zip with the binaries
Unzip the SSL tool. Open the CMD on the location of the Bins
Run the following commands:openssl genrsa -aes256 -out my_private_key.pem 2048openssl rsa -pubout -in my_private_key.pem -out my_public_key.pem
A password will be prompted for the Private Key. Be sure to put one in.
The key files will be generated with the name you choose on that bin folder. You can upload them in the Docusign Configurator
Mac:
ssh-keygen -t rsa -m pem -f MyKey_private.pemA password will be prompted for the Private Key. Be sure to put one in.
ssh-keygen -f MyKey_private.pem -e -m pem > MyKey_public.pem
Setting up the DocuSign credentials
Before you can use the DocuSign connector you must create an account with DocuSign and generate an Integration Key. You can do this on their Sandbox: https://developers.docusign.com/
Once you've done that, you'll need the following details to input into the DocuSign connector in Service Center:
The following page can be found under Admin > API and Keys.
Once that is done, open the DocuSign connector module in Service Center and navigate to the Site Properties as shown below. Enter the values you collected from the DocuSign Sandbox.
You are now all set to use the DocuSign connector. Try it out with the demo app provided!