Check workflow instance status before cancelling it (#226)

* check workflow instance status

Author: RomanBachaloSigmaSoftware

lib/maestro/controllers/eg004CancelWorkflow.js

@@ -8,14 +8,15 @@ const path = require('path');
 const { formatString, API_TYPES } = require('../../utils.js');
 const { getExampleByNumber } = require('../../manifestService');
 const dsConfig = require('../../../config/index.js').config;
-const { cancelWorkflow } = require('../examples/cancelWorkflow');
+const { getWorkflowInstance, cancelWorkflow } = require('../examples/cancelWorkflow');
 
 const eg004CancelWorkflow = exports;
 const exampleNumber = 4;
 const eg = `mae00${exampleNumber}`; // This example reference.
 const api = API_TYPES.MAESTRO;
 const mustAuthenticate = '/ds/mustAuthenticate';
 const minimumBufferMin = 3;
+const inProgressWorkflowStatus = 'In Progress';
 
 /**
  * Trigger workflow
@@ -83,6 +84,23 @@ eg004CancelWorkflow.getController = async (req, res) => {
     return res.render('pages/error', { errorCode, errorMessage, errorInfo });
   }
 
+  const args = {
+    workflowId: req.session.workflowId,
+    instanceId: req.session.instanceId,
+    accessToken: req.user.accessToken,
+    basePath: dsConfig.maestroApiUrl,
+    accountId: req.session.accountId,
+  };
+
+  const instance = await getWorkflowInstance(args);
+
+  if (instance.workflowStatus.toLocaleLowerCase() !== inProgressWorkflowStatus.toLocaleLowerCase()) {
+    const errorCode = '400';
+    const errorMessage = 'Invalid workflow status';
+    const errorInfo = example.CustomErrorTexts[2].ErrorMessage;
+    return res.render('pages/error', { errorCode, errorMessage, errorInfo });
+  }
+
   const sourceFile =
     path.basename(__filename)[5].toLowerCase() +
     path.basename(__filename).substr(6);

lib/maestro/examples/cancelWorkflow.js

@@ -1,5 +1,15 @@
 const iam = require('@docusign/iam-sdk');
 
+const getWorkflowInstance = async (args) => {
+  const client = new iam.IamClient({ accessToken: args.accessToken });
+
+  return await client.maestro.workflowInstanceManagement.getWorkflowInstance({
+    accountId: args.accountId,
+    workflowId: args.workflowId,
+    instanceId: args.instanceId
+  });
+};
+
 const cancelWorkflow = async (args) => {
   //ds-snippet-start:Maestro4Step2
   const client = new iam.IamClient({ accessToken: args.accessToken });
@@ -14,4 +24,4 @@ const cancelWorkflow = async (args) => {
   //ds-snippet-end:Maestro4Step3
 };
 
-module.exports = { cancelWorkflow };
+module.exports = { getWorkflowInstance, cancelWorkflow };