SignNow Workflow Sample - Multiple Signers

1. Launch Workflow Composer and open the workflow. See Open the Workflow for a Sequence.

2. In Workflow Composer, drag the state icons and transition lines to so that you can easily locate each item in the StateMachine workflow.

   

The workflow requires the following arguments and variables. You can create these arguments and variables before working on the activities, or you can add them when they are needed for a specific activity (as described below).

Keep in mind that arguments are passed in JSON format and that JSON elements are case sensitive. Be sure to match the casing of argument names in Workflow Composer and Form Designer.

Arguments

LogLine Activities

While testing and troubleshooting the workflow, we recommend adding LogLine activities at critical stages within the workflow. The following expression will provide logging for specific objects (replace <object> with the object name):

Newtonsoft.Json.JsonConvert.SerializeObject(<object>, Newtonsoft.Json.Formatting.Indented)

We recommend setting the Level value to Information for any LogLine or LogObject activities. See Best Practices for Logging and Logging in Azure.

Note: If your sequence is non-authenticated (Anonymous=true), the LookupUser and GetEntity activities are not applicable, but a CreateEntity activity may be needed instead. Be sure that any anonymous sequence includes the user's email address. It is required as the SignNow recipient address.

Use the Welcome  form to retrieve the Student Id and Student Entity.

1. Double-click the icon of the Welcome state.

2. Create a variable named studentid of Type Int32.

3. Drop a LookupUser activity into the Entry area of the Welcome state.

   • In the UserId property, specify the studentid variable.
   • In the UserName property, specify formInstance.UserName.

4. Drop a GetEntity activity below the LookupUser activity.

   • In the EntityId property, specify the studentid variable.
   • In the Result property, specify studentEntity.

   

5. Save the workflow locally and continue with the next set of steps.

Since the workflow can be busy for a long time, we recommend that you persist the workflow instance before creating the PDF.

1. Double-click the Next transition between the SignNowCoSigner and Default-Frame states.

   

2. Set the Condition to True.

3. Drag a Persist activity into the Trigger area below the Next activity. The Persist activity does not require any properties to be specified.

   Workflow Composer automatically wraps the Next and Persist activities in a Sequence.

   

4. Save the workflow locally and continue with the next set of steps.

1. Create a variable named URL. Set the Variable type to String. Set the Scope to StateMachine. This variable will be assigned to the PDF created from the form.

2. Create a variable with a name like Pdf. Set the Scope to StateMachine. This variable will hold the document image created from the form.

   Note: Make sure you use the same variable name when you reference this variable later in the workflow. (This applies to any other variable.)

   1. In the Variable type field, select Array of [T] and select Browse for Type.

   2. In the "Browse and Select a .Net Type" window, specify byte, select the System variable Byte, and click OK.

      

3. Drop a PrintUrlToPdf activity below the Persist activity.

   Specify the properties for the activity as follows:

   • PdfDocument = Pdf (This is the name of the variable created above.)

   • Url = URL (This is the name of the variable created above.)

   • Validation Messages = formInstance.ValidationMessages

   

4. Save the workflow locally and continue with the next set of steps.

In the following steps we will continue to add activities to the Next transition between the SignNowCoSigner and Default-Frame states.

1. Create a variable named SignNowConfig. Set the Scope to StateMachine.

   In the Variable type field, select Browse for Type. In the "Browse and Select a .Net Type" window, scroll down to Cmc.Nexus.FormsBuilder.Contracts > Cmc.Nexus.FormsBuilder.Entities and select SignNowConfig.

2. Drop a GetSignNowConfig activity below the PrintUrlToPdf activity.

   Specify the properties for the activity as follows:

   • SignNowConfig = SignNowConfig
   • Validation Messages = formInstance.ValidationMessages

   The GetSignNowConfig activity retrieves your user credentials from the SignNow settings in Forms Builder. These values enable the workflow to log in to SignNow.

3. Create the following variables:

   Variable Name	Type	Scope	Default
   SignNowRecipient	Cmc.Nexus.FormsBuilder.Entities.SignNowRecipient	StateMachine	new SignNowRecipient
   SignNowRecipient2	Cmc.Nexus.FormsBuilder.Entities.SignNowRecipient	StateMachine	new SignNowRecipient
   SignNowDocument	Cmc.Nexus.FormsBuilder.Entities.SignNowDocument	StateMachine	new SignNowDocument
   SignNowRequest	Cmc.Nexus.FormsBuilder.Entities.SignNowRequest	StateMachine	N/A

4. Below the GetSignNowConfig activity, drop an Assign activity for each row in the following table and type the indicated values:

   "To" Field	Value	Notes
   SignNowConfig.EmailSubject	"CMC SignNow Test at " + DateTime.Now.ToString()	This is the email that the end user will receive after the signing process is done.
   SignNowDocument.DocumentId	"1"	The SignerId should match the Signer property in the SignNow component on the form. Allowed values are "1" to "5".
   SignNowDocument.Name	"NewMultiSignNow.pdf"	Name of the signed document.
   SignNowDocument.Content	Pdf	Name of the variable that holds the document image (see Create a PDF of the Form). In our example the name of the variable is Pdf.
   SignNowRecipient.FirstName	studentEntity.FirstName	First name of the user who submitted the signed document.
   SignNowRecipient.LastName	studentEntity.LastName	Last name of the user who submitted the signed document.
   SignNowRecipient.Email	SignNowConfig.SignerAccountEmail	Email address of the person who will receive the signed SignNow document.
   SignNowRecipient2.FirstName	signer2First	First name of the co-signer who submitted the signed document. This could be a parent name from the StudentRelationshipAddressEntity.
   SignNowRecipient2.LastName	signer2Last	Last name of the co-signer who submitted the signed document. This could be a parent name from the StudentRelationshipAddressEntity.
   SignNowRecipient2.Email	signer2Email	Email address of the co-signer who will receive the signed SignNow document. This could be the email address retrieved from the StudentRelationshipAddressEntity.
   SignNowRecipient2.SignerId	"2"	The SignerId should match the Signer property in the SignNow component on the form. Allowed values are "1" to "5".

5. Save the workflow locally and continue with the next set of steps.

In the following steps we will continue to add activities to the Next transition between the SignNowCoSigner and Default-Frame states.

1. Drop the CreateSignNowRequest activity below the previous activity.

   Specify the properties using the names of the variables created above as follows:

   

   Notes: 

   • The expression for SignNowRecipients passes multiple items (the primary and secondary recipient) within an array.

   • The ResumeBookmark value will be passed to SignNow as a custom field. When the signature request has been completed, SignNow will return this flag and any process that has to happen after the bookmark can resume automatically without any user intervention.

   • The out argument SignNowRequest returns the URL of the signed SignNow document.

   

2. Drop an Assign activity below the CreateSignNowRequest activity.

   1. In the To field, specify frameUrl. (This is the argument associated with the IFrame form.)

       Be sure to use the exact casing shown here. 

   2. In the Value field, specify SignNowRequest.Url.

3. Save the workflow locally and continue with the next set of steps.

The IFrame form (Default-Frame) will receive the SignNow document with the first signature, but the signing process is not yet complete. We want the workflow to continue with the SignNowWait  form upon receipt of the first signature. The workflow will pause on the SignNowWait  form until the second signature is received. If user closes the form or logs out after submitting the first signature, upon return to the form, the workflow will display the SignNowWait  form.

1. Double-click the transition from the Default-Frame form to the SignNowWait  form.

2. In the Trigger area, name the WaitForFormBookmark as Continue.

3. Select the property Transition Type = MoveForward on the WaitForFormBookmark activity.

4. Drop a GetSignNowRecipientStatus activity below the Continue WaitForFormBookmark.

   Specify the properties using the names of the variables created above as follows:

   

5. Specify the Condition as SignNowRecipients(0).Status.Equals("fulfilled").

   

6. Select the Default-Frame state and drag a line from the Default-Frame state to the SignNowCoSigner state to create a new transition (T1).

7. Change the T1 label to Retry and add the following condition:

   Not SignNowRecipients(0).Status.Equals("fulfilled")

   

8. Drag a CreateValidationItem activity into the Action area of the Retry transition and specify the following properties:

   

9. Save the workflow locally and continue with the next set of steps.

In the following steps, we will create activities in the Done transition before the End state. At this point in the workflow, the second signature was received and the SignNow document is complete.

1. Double-click the Done transition before the End state and rename the WaitForFormBookmark activity as Continue when all signatures are collected. SignNow returns the string "Continue when all signatures are collected" in the custom field named "Bookmark".

   

2. Create a variable named SignNowSignedDocument. In the Variable type field, select SignNowDocument. Set the Scope to StateMachine.

3. Drop a GetSignNowSignedDocument activity into the Action area.

   Specify the properties for the activity as follows:

   

4. Save the workflow locally and continue with the next set of steps.

To convert a SignNow document to a DocumentEntity that can be attached to a record in Anthology Student, add CreateDocument and SaveDocument activities to the workflow. These activities will be placed below the GetSignNowSignedDocument activity.

1. Create a variable named Doc. Set the Scope to StateMachine.

   In the Variable type field, select Browse for Type. In the "Browse and Select a .Net Type" window, scroll down to Cmc.Nexus.Crm.Contracts > Cmc.Nexus.Crm.Entities and select DocumentEntity.

2. Drop a CreateDocument activity below the GetSignNowSignedDocument activity.

   Specify the properties as shown below activity and use the drop-down field in the activity to select appropriate values:

   • Module = Select a Module from the drop-down list, e.g., Admissions.
   • Document Type = Select a Type (Template) from the drop-down list.
   • Document Status = Select a Type from the drop-down list.
   • Student = Specify a Student Id or use a variable.
   • Due Date = Specify a date or use a variable, e.g., DateTime.Now
   • Document (OutArgument) = Doc (This is the variable created above for the DocumentEntity.)
   • Validation Messages = formInstance.ValidationMessages

   

3. Below the CreateDocument activity, drop an Assign activity for each row in the following table and type the indicated values:

   "To" Field	Value
   doc.OriginalFileName	SignNowDocument.Name
   doc.DocumentImage	SignNowSignedDocument.Content
   doc.ImageType	"Pdf"
   doc.IsDocumentAddedManually	true

4. Drop a SaveDocument activity below the last Assign activity.

   Specify the properties for the SaveDocument activity as follows:

   • Document (InOutArgument) = Doc (This is the variable created above for the DocumentEntity.)
   • Validation Messages = formInstance.ValidationMessages

   

5. Save the workflow locally and continue with the next set of steps.

1. Click Publish. The New Workflow Definition Version window is displayed.

2. If you want the workflow to be run as soon as the event occurs on the entity, select Enable This Workflow Version?, otherwise leave the check box cleared.

3. Click Save, then Cancel to close the publisher window.

4. In the Sequence List, select and complete the form that contains the SignNow fields.

5. Verify that the signed SignNow document is available at the return URL.

Note: While testing your workflow, make sure that you terminate the previous instance of the workflow before running an updated version of the same workflow. In Workflow Composer, click Open Persisted Workflow, select your workflow instance, and click Terminate.

Persisted workflow instances can be also deleted from the Sequence Designer workspace. For more information, see Delete Persisted Workflow Instances.