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

Author: Raileen Del Rosario

examples/Maestro/eg001TriggerWorkflow.ps1

@@ -37,7 +37,7 @@ $headers.add("Content-Type", "application/json")
 $headers.add("Accept", "application/json")
 #ds-snippet-end:Maestro1Step2
 
-Write-Output "Attempting to retrieve Workflow definition..."
+Write-Output "Attempting to retrieve the workflow definition..."
 
 #ds-snippet-start:Maestro1Step3
 Invoke-RestMethod `
@@ -75,13 +75,21 @@ if (-not ([string]::IsNullOrEmpty($triggerUrl))) {
  #ds-snippet-start:Maestro1Step5
  $triggerResult = Invoke-WebRequest -uri $triggerUrl -headers $headers -body $body -method POST -UseBasicParsing
  #ds-snippet-end:Maestro1Step5
+ Write-Host $triggerResult
+ Write-Host ""
+
+ $workflowInstanceId = $($triggerResult | ConvertFrom-Json).instance_id
+ $workflowInstanceId | Out-File -FilePath "config/INSTANCE_ID" -Encoding utf8 -Force
+ Write-Host "Successfully created and published workflow $workflowInstanceId, ID saved to config/INSTANCE_ID"
+
 
  $instanceUrl = $($triggerResult | ConvertFrom-Json).instance_url
  # Decode escaped characters
  $instanceUrl = $instanceUrl -replace "\\u0026", "&"
  Write-Host "Use this URL to complete the workflow steps:"
  Write-Host $instanceUrl
 
+
  Write-Host ""
  Write-Host "Opening a browser with the embedded workflow..."
 

examples/Maestro/eg004CancelWorkflow.ps1

@@ -0,0 +1,56 @@
+# Cancel a workflow instance
+
+# Check that there is a workflow
+if (Test-Path .\config\WORKFLOW_ID) {
+ $workflowId = Get-Content .\config\WORKFLOW_ID
+} else {
+ Write-Output "Please run example 1 to create and trigger a workflow before running this example,"
+ exit 0
+}
+
+# Check that there is a running workflow instance to cancel
+if (Test-Path .\config\INSTANCE_ID) {
+ $workflowInstanceId = Get-Content .\config\INSTANCE_ID
+} else {
+ Write-Output "Please run example 1 to trigger a workflow before running this example."
+ exit 0
+}
+
+$base_path = "https://api-d.docusign.com/v1"
+
+# Step 1: Obtain your OAuth token
+# Note: Substitute these values with your own
+$accessToken = Get-Content .\config\ds_access_token.txt
+
+# Set up variables for full code example
+# Note: Substitute these values with your own
+$apiAccountId = Get-Content .\config\API_ACCOUNT_ID
+
+# temp file:
+$response = New-TemporaryFile
+
+# Construct your API headers
+#ds-snippet-start:Maestro4Step2
+$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
+$headers.add("Authorization", "Bearer $accessToken")
+$headers.add("Content-Type", "application/json")
+$headers.add("Accept", "application/json")
+#ds-snippet-end:Maestro4Step2
+
+Write-Output "Attempting to cancel the Workflow instance..."
+
+#ds-snippet-start:Maestro4Step3
+Invoke-RestMethod `
+ -Uri "${base_path}/accounts/${apiAccountId}/workflows/${workflowId}/instances/${workflowInstanceId}/actions/cancel" `
+ -Method 'POST' `
+ -Headers $headers `
+ -OutFile $response
+
+#Write-Output "Workflow instance $workflowInstanceId has been canceled."
+Write-Output "Response: $(Get-Content -Raw $response)"
+#ds-snippet-end:Maestro4Step3
+
+# cleanup
+Remove-Item $response
+
+Write-Output "Done."

launcher.ps1

@@ -1022,20 +1022,24 @@ function startMaestro {
  do {
  Enum listMaestroExamples {
  triggerWorkflow = 1;
- Pick_An_API = 2;
+ cancelWorkflow = 4;
+ Pick_An_API = 5;
  }
  $listMaestroExamplesView = $null;
  do {
  Write-Output ""
  Write-Output 'Select the action: '
  Write-Output "$([int][listMaestroExamples]::triggerWorkflow)) How to trigger a Maestro workflow"
+ Write-Output "$([int][listMaestroExamples]::cancelWorkflow)) How to cancel a Maestro workflow"
  Write-Output "$([int][listMaestroExamples]::Pick_An_API)) Pick_An_API"
  [int]$listMaestroExamplesView = Read-Host "Select the action"
  } while (-not [listMaestroExamples]::IsDefined([listMaestroExamples], $listMaestroExamplesView));
 
  if ($listMaestroExamplesView -eq [listMaestroExamples]::triggerWorkflow) {
  Invoke-Script -Command "`".\examples\Maestro\eg001TriggerWorkflow.ps1`""
 
+ } elseif ($listMaestroExamplesView -eq [listMaestroExamples]::cancelWorkflow) {
+ Invoke-Script -Command "`".\examples\Maestro\eg004CancelWorkflow.ps1`""
  }
 
  } until ($listMaestroExamplesView -eq [listMaestroExamples]::Pick_An_API)