Merge pull request #22 from sriharip-docusign/get_doc_id

FLOW-345: DocGen: Get document id given a document name

Author: sriharip-docusign

certified-connectors/DocuSignDemo/apiDefinition.swagger.json

@@ -293,7 +293,7 @@
             "description": "Account id",
             "required": true,
             "x-ms-summary": "Account",
-            "x-ms-test-value": "insert test value",
+            "x-ms-test-value": "insert account id",
             "x-ms-dynamic-values": {
               "operationId": "GetLoginAccounts",
               "value-collection": "loginAccounts",
@@ -2401,6 +2401,57 @@
         "x-ms-visibility": "important"
       }
     },
+    "/accounts/{accountId}/envelopes/{envelopeId}/get_document_id": {
+      "get": {
+        "summary": "Get document id",
+        "description": "Get document id",
+        "operationId": "GetDocumentId",
+        "parameters": [
+          {
+            "name": "accountId",
+            "in": "path",
+            "description": "Account id",
+            "required": true,
+            "x-ms-summary": "Account",
+            "x-ms-test-value": "insert account id",
+            "x-ms-dynamic-values": {
+              "operationId": "GetLoginAccounts",
+              "value-collection": "loginAccounts",
+              "value-path": "accountIdGuid",
+              "value-title": "name"
+            },
+            "type": "string"
+          },
+          {
+            "name": "envelopeId",
+            "in": "path",
+            "description": "Envelope id",
+            "required": true,
+            "x-ms-summary": "Envelope",
+            "x-ms-test-value": "insert envelope id",
+            "type": "string"
+          },
+          {
+            "name": "documentName",
+            "in": "query",
+            "description": "File name with extension",
+            "required": true,
+            "x-ms-summary": "Document name",
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/EnvelopeDocument"
+            }
+          }
+        },
+        "deprecated": false,
+        "x-ms-visibility": "advanced"
+      }
+    },    
     "/signers/accounts/{accountId}/templates/{templateId}/recipients": {
       "get": {
         "tags": [
@@ -4033,13 +4084,13 @@
           "description": "The id of the document.",
           "type": "string",
           "x-ms-summary": "Document Id",
-          "x-ms-visibility": "advanced"
+          "x-ms-visibility": "important"
         },
         "name": {
           "description": "The name of the document.",
           "type": "string",
           "x-ms-summary": "Name",
-          "x-ms-visibility": "advanced"
+          "x-ms-visibility": "important"
         }
       }
     },

certified-connectors/DocuSignDemo/script.csx

@@ -1553,6 +1553,13 @@ public class Script : ScriptBase
       this.Context.Request.RequestUri = uriBuilder.Uri;
     }
 
+    if ("GetDocumentId".Equals(this.Context.OperationId, StringComparison.OrdinalIgnoreCase))
+    {
+      var uriBuilder = new UriBuilder(this.Context.Request.RequestUri);
+      uriBuilder.Path = uriBuilder.Path.Replace("/get_document_id", "/documents");
+      this.Context.Request.RequestUri = uriBuilder.Uri;
+    }
+
     if ("GetLoginAccounts".Equals(this.Context.OperationId, StringComparison.OrdinalIgnoreCase))
     {
       var uriBuilder = new UriBuilder(this.Context.Request.RequestUri);
@@ -1897,6 +1904,31 @@ public class Script : ScriptBase
       response.Content = new StringContent(newBody.ToString(), Encoding.UTF8, "application/json");
     }
 
+    if ("GetDocumentId".Equals(this.Context.OperationId, StringComparison.OrdinalIgnoreCase))
+    {
+      var body = ParseContentAsJObject(await response.Content.ReadAsStringAsync().ConfigureAwait(false), false);
+      var query = HttpUtility.ParseQueryString(this.Context.Request.RequestUri.Query);
+      var documentName = query.Get("documentName");
+      var newBody = new JObject();
+
+      foreach (var documentInfo in (body["envelopeDocuments"] as JArray) ?? new JArray())
+      {
+        if (documentName.Equals(documentInfo["name"].ToString()))
+        {
+          newBody["documentId"] = documentInfo["documentIdGuid"];
+          newBody["name"] = documentInfo["name"];
+          break;
+        }
+      }
+
+      if (newBody["documentId"] == null)
+      {
+        throw new ConnectorException(HttpStatusCode.BadRequest, "ValidationFailure: No document found matching the provided name");
+      }      
+
+      response.Content = new StringContent(newBody.ToString(), Encoding.UTF8, "application/json");
+    }
+
     if (response.Content?.Headers?.ContentType != null)
     {
       if ("GetDocuments".Equals(this.Context.OperationId, StringComparison.OrdinalIgnoreCase))