Merge branch 'master' of https://github.com/docusign/code-examples-csharp-private

Author: karissarjacobsen

launcher-csharp/Maestro/Controllers/Mae004CancelWorkflowInstanceController.cs

@@ -16,6 +16,7 @@ namespace DocuSign.CodeExamples.Controllers
     public class Mae004CancelWorkflowInstanceController : EgController
     {
         private const int StatusCode = 500;
+        private const string InProgress = "In Progress";
 
         public Mae004CancelWorkflowInstanceController(DsConfiguration dsConfig,
             LauncherTexts launcherTexts,
@@ -69,6 +70,20 @@ public IActionResult Create()
 
             try
             {
+                var workflowInstance = CancelWorkflowInstance.GetWorkflowInstanceStatus(
+                    basePath,
+                    accessToken,
+                    accountId,
+                    workflowId,
+                    workflowInstanceId).Result;
+
+                if (workflowInstance.WorkflowStatus != null && !workflowInstance.WorkflowStatus.Equals(InProgress))
+                {
+                    this.ViewBag.h1 = this.CodeExampleText.ExampleName;
+                    this.ViewBag.message = this.CodeExampleText.CustomErrorTexts[2].ErrorMessage;
+                    return this.View("example_done");
+                }
+
                 var cancelWorkflowInstanceResponse = CancelWorkflowInstance.CancelInstanceMaestroWorkflow(
                     basePath,
                     accessToken,

launcher-csharp/Maestro/Examples/CancelWorkflowInstance.cs

@@ -24,6 +24,17 @@ public static async Task<CancelWorkflowInstanceResponse> CancelInstanceMaestroWo
 
         //ds-snippet-end:Maestro4Step3
 
+        public static async Task<WorkflowInstance> GetWorkflowInstanceStatus(
+            string basePath,
+            string accessToken,
+            string accountId,
+            string workflowId,
+            string workflowInstanceId)
+        {
+            var client = CreateAuthenticatedClient(basePath, accessToken);
+            return await client.Maestro.WorkflowInstanceManagement.GetWorkflowInstanceAsync(accountId, workflowId, workflowInstanceId);
+        }
+
         /// <summary>
         /// Creates an authenticated IAM client.
         /// </summary>

manifest/CodeExamplesManifest.json

@@ -2911,8 +2911,8 @@
           "Examples": [
             {
               "ExampleNumber": 1,
-              "ExampleName": "How to trigger a Maestro workflow",
-              "ExampleDescription": "Trigger a workflow",
+              "ExampleName": "Trigger a Maestro workflow",
+              "ExampleDescription": "This example demonstrates how to trigger a Maestro workflow",
               "LinksToAPIMethod": [
                 {
                   "Path": "https://developers.docusign.com/docs/maestro-api/reference/maestro/workflows/triggerworkflow/",
@@ -2964,7 +2964,7 @@
             {
               "ExampleNumber": 2,
               "ExampleName": "Pause a running workflow instance",
-              "ExampleDescription": "how to create an envelope where the workflow is paused before the envelope is sent to a second recipient",
+              "ExampleDescription": "This example demonstrates how to create an envelope where the workflow is paused before the envelope is sent to a second recipient",
               "LinksToAPIMethod": [
                 {
                   "Path": "https://developers.docusign.com/docs/maestro-api/reference/maestro/workflows/pausenewworkflowinstances/",
@@ -3025,6 +3025,10 @@
                 {
                   "ErrorMessageCheck": "NO_WORKFLOW_ID_FOUND",
                   "ErrorMessage": "Unable to retrieve workflow instance: {0}."
+                },
+                {
+                  "ErrorMessageCheck": "NO_WORKFLOW_INSTANCE_COMPLETED",
+                  "ErrorMessage": "The workflow instance has been completed and can no longer be canceled. Please trigger the workflow instance again, but stop before completing the signing process, then try running it once more."
                 }
               ],
               "ResultsPageText": "Workflow has been canceled.",