Connect Node Worker for Azure

This is an example worker application for Connect webhook notification messages sent via the Azure Service Bus platform.

This application receives DocuSign Connect messages from the queue and then processes them:

1. If the envelope is complete, the application uses a DocuSign JWT Grant token to retrieve the envelope's combined set of documents, and stores them in the output directory.

   The envelope must include an Envelope Custom Field named Sales order. The Sales order field is used to name the output file.

2. Optionally, this worker app can be configured to also change the color of an LIFX bulb (or set of bulbs) to the color set in the envelope's Custom Field Light color

Architecture

This figure shows the solution's architecture. This worker application is written in Node.js. But it could be written in a different language.

Azure has SDK libraries for Message Bus clients for C#, Java, Node.js, Python, and Ruby.

Installation

1. Install the example Connect listener for Azure on Azure. At the end of this step, you will have the Service Bus Connection String and the Service Bus Queue Name.

2. Install the latest Long Term Support version of Node v8.x or v10.x on your system, with the npm package manager.

3. Configure a DocuSign Integration Key for the application. The application uses the OAuth JWT Grant flow.

   If consent has not been granted to the application by the user, then the application provides a url that can be used to grant individual consent.

   To enable individual consent: either add the URL https://www.docusign.com as a redirect URI for the Integration Key, or add a different URL and update the oAuthConsentRedirectURI setting in the ds_configuration.js file.

4. Download this repo to a directory.

5. In the directory:

   npm install

6. Configure ds_configuration.js or set the environment variables as indicated in that file.

7. Start the listener:

   npm start

Testing

Configure a DocuSign Connect subscription to send notifications to the Cloud Function. Create / complete a DocuSign envelope. The envelope must include an Envelope Custom Field named "Sales order".

• Check the Connect logs for feedback.

• Check the console output of this app for log output.

• Check the output directory to see if the envelope's combined documents and CoC were downloaded.

  By default, the documents will only be downloaded if the envelope is complete and includes a Sales order custom field.

Semi-automatic testing

The repo includes a runTest.js file. It conducts an end-to-end integration test of enqueuing and dequeuing test messages. See the file for more information.

License and Pull Requests

License

This repository uses the MIT License. See the LICENSE file for more information.

Pull Requests

Pull requests are welcomed. Pull requests will only be considered if their content uses the MIT License.