Merge branch 'DEVDOCS-16858' into DEVDOCS-16852

Author: nianiB9

examples/Maestro/eg001TriggerWorkflow.sh

@@ -1,5 +1,4 @@
 #!/bin/bash
-# https://developers.docusign.com/docs/workflows-api/trigger-workflow
 # Trigger a new instance of a workflow
 #
 # Check that we're in a bash shell
@@ -150,9 +149,9 @@ Status=$(curl -s -w "%{http_code}\n" -i --request POST ${decoded_trigger_url} \
 #ds-snippet-end:Maestro1Step5
 
 
-instance_id=`cat $response | grep instance_id | sed 's/.*\"instance_id\":\"//' | sed 's/\".*//'`
+instance_id=$(grep '"instance_id":' $response | sed -n 's/.*"instance_id": "\([^"]*\)".*/\1/p')
 # Store the instance_id into the config file
-echo $instance_id >config/INSTANCE_ID
+echo "${instance_id}" > config/INSTANCE_ID
 
 echo ""
 echo "Response:"

examples/Maestro/eg002PauseWorkflow.sh

@@ -0,0 +1,64 @@
+#!/bin/bash
+# Pause a running workflow instance
+#
+# Check that we're in a bash shell
+if [[ $SHELL != *"bash"* ]]; then
+    echo "PROBLEM: Run these scripts from within the bash shell."
+fi
+
+# Check that there is a workflow
+workflow_id=$(cat config/WORKFLOW_ID)
+if [ -z "$workflow_id" ]; then
+    echo "Please run example 1 to create and trigger a worklow before running this example."
+    exit 0
+fi
+
+# Obtain your OAuth token
+# Note: Substitute these values with your own
+ACCESS_TOKEN=$(cat config/ds_access_token.txt)
+
+
+# Set up variables for full code example
+# Note: Substitute these values with your own
+ACCOUNT_ID=$(cat config/API_ACCOUNT_ID)
+
+base_path="https://api-d.docusign.com/v1"
+
+# Construct your API headers
+#ds-snippet-start:Maestro2Step2
+declare -a Headers=('--header' "Authorization: Bearer ${ACCESS_TOKEN}" \
+    '--header' "Accept: application/json" \
+    '--header' "Content-Type: application/json")
+#ds-snippet-end:Maestro2Step2
+echo ""
+echo "Attempting to pause the Workflow.."
+echo ""
+
+#ds-snippet-start:Maestro2Step3
+response=$(mktemp /tmp/response-wftmp.XXXXXX)
+Status=$(
+    curl -w '%{http_code}' --request POST "${base_path}/accounts/${ACCOUNT_ID}/workflows/${workflow_id}/actions/pause" \
+    "${Headers[@]}" \
+    --output ${response}
+)
+# If the status code returned is greater than 201 (OK / Accepted), display an error message with the API response.
+if [[ "$Status" -gt "201" ]]; then
+    echo ""
+    echo "Unable to retrieve workflow instance: ${WORKFLOW_INSTANCE_ID}"
+    echo ""
+    cat $response
+    exit 0
+fi
+
+echo ""
+echo "Workflow has been paused."
+echo ""
+echo ""
+echo "Response:"
+cat $response
+echo ""
+echo ""
+#ds-snippet-end:Maestro2Step3
+
+# Remove the temporary files
+rm "$response"

examples/Maestro/eg004CancelWorkflow.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# Cancel a running workflow instance
+#
+# Check that we're in a bash shell
+if [[ $SHELL != *"bash"* ]]; then
+    echo "PROBLEM: Run these scripts from within the bash shell."
+fi
+
+# Check that there is a workflow
+workflow_id=$(cat config/WORKFLOW_ID)
+if [ -z "$workflow_id" ]; then
+    echo "Please run example 1 to create and trigger a worklow before running this example."
+    exit 0
+fi
+
+# Check that there is a running workflow instance to cancel
+WORKFLOW_INSTANCE_ID=$(cat config/INSTANCE_ID)
+if [ -z "$WORKFLOW_INSTANCE_ID" ]; then
+    echo "Please run example 1 to trigger a workflow before running this example."
+    exit 0
+fi
+
+# Obtain your OAuth token
+# Note: Substitute these values with your own
+ACCESS_TOKEN=$(cat config/ds_access_token.txt)
+
+
+# Set up variables for full code example
+# Note: Substitute these values with your own
+ACCOUNT_ID=$(cat config/API_ACCOUNT_ID)
+
+base_path="https://api-d.docusign.com/v1"
+
+# Construct your API headers
+#ds-snippet-start:Maestro4Step2
+declare -a Headers=('--header' "Authorization: Bearer ${ACCESS_TOKEN}" \
+    '--header' "Accept: application/json" \
+    '--header' "Content-Type: application/json")
+#ds-snippet-end:Maestro4Step2
+echo ""
+echo "Attempting to cancel the Workflow instance..."
+echo ""
+
+#ds-snippet-start:Maestro4Step3
+response=$(mktemp /tmp/response-wftmp.XXXXXX)
+Status=$(
+    curl -w '%{http_code}' --request POST "${base_path}/accounts/${ACCOUNT_ID}/workflows/${workflow_id}/instances/${WORKFLOW_INSTANCE_ID}/actions/cancel" \
+    "${Headers[@]}" \
+    --output ${response}
+)
+# If the status code returned is greater than 201 (OK / Accepted), display an error message with the API response.
+if [[ "$Status" -gt "201" ]]; then
+    echo ""
+    echo "Unable to retrieve workflow instance: ${WORKFLOW_INSTANCE_ID}"
+    echo ""
+    cat $response
+    exit 0
+fi
+
+echo ""
+echo "Workflow has been canceled."
+echo ""
+echo ""
+echo "Response:"
+cat $response
+echo ""
+echo ""
+#ds-snippet-end:Maestro4Step3
+
+# Remove the temporary files
+rm "$response"

launcher.sh

@@ -975,6 +975,8 @@ function startMaestro() {
     PS3='Select the action : '
     select CHOICE in \
         "Trigger_Workflow" \
+        "Pause_Workflow" \
+        "Cancel_Workflow" \
         "Home"; do
         case "$CHOICE" in
         Home)
@@ -984,6 +986,14 @@ function startMaestro() {
             bash examples/Maestro/eg001TriggerWorkflow.sh
             startMaestro
             ;;
+        Pause_Workflow)
+            bash examples/Maestro/eg002PauseWorkflow.sh
+            startMaestro
+            ;;
+        Cancel_Workflow)
+            bash examples/Maestro/eg004CancelWorkflow.sh
+            startMaestro
+            ;;
         *)
             echo "Default action..."
             startMaestro