Send a report generated in HEFLO to sign on DocuSign

In this article we will see how to configure a process to send a report generated in HEFLO to be signed on DocuSign.

We use this example process to demonstrate this configuration:


When the user creates a work item in this process, he must first generate a report in the first task and add it in a “Files Upload” field. When he moves on to the next task, the system then sends information to DocuSign, which is called an “envelope”. The work item then waits to receive information from DocuSign. Depending on the status of the relevant document, the work item will follow one of 3 different exclusive gateway output flows. Each of the three tasks following the gateway aims to display the document and its associated status in DocuSign.

Add a task to generate a report and attach it to a field.

The goal is to give the user responsible for the first task the ability to generate a report and attach it to the field that will be used to create and send the envelope to DocuSign.

  1. Open the form associated with the first task.
  2. Add the “Files Upload” type field which will be used to create the envelope.
  3. Hover your mouse in the form to a place that does not yet contain a field and click on the gear icon.
  4. Hover your mouse over the newly created item and click the pencil icon.
    1. Choose the label you want to appear in the form.
    2. In the “Action” section, choose the “Show report” option.
    3. Choose a report from those created in your environment.

When the user is on this work item task, he will then be able to click on the button that was created to generate the report and attach it to the “Files Upload” type field of this form.

Configure an envelope creation and sending task.

The second step is to configure the task that will create the envelope and send it to DocuSign. The objective is to configure the document that will be sent, the list of recipient(s) and personalize the message that will be sent by DocuSign.

  1. Select the relevant task.
  2. Make sure this is a message type task with throw behavior. For information: the envelope sending configuration is only possible for message type tasks, it is not possible to use a message sending event.
  3. Go to the properties and choose the connector: “Document signature”.
  4. Choose the “Create and send” operation.
  5. In the account section, choose the DocuSign account associated with your HEFLO environment. To learn more about how to associate a DocuSign account with your HEFLO environment: Configure DocuSign integration.

 

From this moment, two new buttons appear:

  • The “Development” button allows you to configure the creation and sending of the envelope for test work items. The “Development” button is linked to the DocuSign developer account associated with this environment.
  • The “Production” button allows you to configure the creation and sending of the envelope for production work items once the process automation is published. The “Production” button is linked to the DocuSign account associated with this environment.

To learn more about the difference between a DocuSign account and a DocuSign developer account: Configure DocuSign integration.

We will now configure the creation and sending of the envelope.

  1. Click the “Development” button.
  2. In the “Envelope” tab you must:
    1. Give the envelope a name.
    2. In the “Documents” section, select the “Files Upload” type field contained in the form of the first task.
    3. In the “Store Folder” section you can choose in which folder of your DocuSign account the document will be sent. If you do not select any folder, your envelope will automatically be stored in the drafts folder.

  3. In the “Recipients” tab you must add one or more recipients by clicking on the “+” button. You must then choose a role from those available in DocuSign, a name and an email address. You can also choose a routing order, this is useful if, for example, you want this recipient to receive the document to be signed before or after other recipients. You can also set up a code to access the document and send a private message.

  4. In the “Message” tab you must configure the name and body of the message that will be sent to all recipients.

     

Then click on confirm to validate this configuration.

Configure an envelope receiving task.

We will now configure the envelope reception task.

  1. Select the relevant task.
  2. Make sure this is a message type task with catch behavior. For information: the envelope reception configuration is feasible for message type tasks and for message reception events.
  3. Go to the properties and choose the connector: “Document signature”.
  4. Choose the “Await envelope” operation.
  5. In the “Envelope Status Field” section, choose the HEFLO field that will retrieve information regarding the status of the envelope in DocuSign. This field must be of “Text” type. When the envelope sent has received action from all the recipients (in the case where the document(s) contained in the envelope have been signed), or one of the recipients (in the case where they have been declined), then this selected field will receive the final status of the envelope. There are three statuses: completed, voided and declined.
  6. In the “Final Combined File” section, choose the HEFLO field that will retrieve the final document contained in DocuSign. This field must be of “Files Upload” type.
  7. Then click on the chain icon and select the task of creating and sending the envelope,
    so that the system knows which envelope this task is associated with. After selecting the creation and sending task, you can then find this information under the chain icon. We advise you to name these tasks well so that you can differentiate them in case you have several envelope creation and sending tasks.

 

In our example, we want the work item to follow an output flow based on the status of the document in DocuSign.

  1. Select the exclusive gateway, go to the properties and activate the “Is Automatic” option in the execution part.
  2. Create a business rule for each output flow using the field chosen in the “Envelope Status Field” section when configuring the task or message reception event. For information: whatever language you use in HEFLO, the DocuSign statuses are in English: “completed”, “voided” and “declined”.
  3. In each of the tasks that follow the gateway, add the two associated fields when configuring the task or the message reception event for the “Envelope Status Field” and “Final Combined File” parts. The goal is to display the status and final document contained in DocuSign.

 

Create a test work item.

The setup is now complete, we will create a test work item.

Click the button: “Click here” to generate the report and attach it to the “Files Upload” type field. For information: If the form contains a single “Files Upload” type field, the system then automatically associates the report with it. If the form contains more than one such field, then you will need to choose which field you want to add the report to.

The task of creating and sending the envelope is transparent to the user. In our configuration, the work item then goes directly to the DocuSign message waiting task. This is then blocked for the message reception type task. Once the envelope is created and sent, the recipient(s) receive an email. The recipient concerned must then follow the instructions explained by DocuSign to sign or decline the document concerned. The action that will be carried out by them will allow the instance to advance automatically and choose the output flow according to the status of the envelope.

 

For information: Once the envelope has been created, you can see the information concerning it.

  1. Click on the button with the three dots.
  2. Click on “Document Signature”.
  3. You then have information concerning the status of the envelope and the actions pending or taken by the recipient(s).

 

You can also access this information if you are on task waiting for information from DocuSign. You can then click on “View details”.

 

We will sign the document.

 

Both recipients in our example signed the document. The work item then follows the “completed” output flow and we can find the document status and signed document in the task following the gateway.

Configure the “Production” part and publish the process automation.

Once the test has been validated, you must then make this same configuration in the “Production” part of the envelope creation and sending task. We advise you to create the same template on your two accounts, the DocuSign developer account and the DocuSign production account, to facilitate the configuration of the “Production” part on HEFLO.

 

Once configured, you can then verify your process using the validation function in the “Actions” tab and publish the process automation.

Was this article helpful?

Related Articles