Merge pull request #21 from sriharip-docusign/update_recipient

FLOW-343: Template Prefill - part 1

Author: sriharip-docusign

certified-connectors/DocuSignDemo/apiDefinition.swagger.json

@@ -1713,6 +1713,215 @@
         "x-ms-no-generic-test": true
       }
     },
+    "/accounts/{accountId}/envelopes/{envelopeId}/recipients/updateRecipient": {
+      "put": { 
+        "tags": [
+          "DocuSign"
+        ],
+        "summary": "Update envelope recipient",
+        "description": "Update envelope recipient.",
+        "operationId": "UpdateEnvelopeRecipient",
+        "consumes": [
+          "application/json",
+          "text/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "text/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "accountId",
+            "in": "path",
+            "description": "Account id",
+            "required": true,
+            "x-ms-summary": "Account",
+            "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",
+            "type": "string"
+          },
+          {
+            "name": "recipientId",
+            "in": "query",
+            "description": "Recipient id",
+            "required": true,
+            "x-ms-summary": "Recipient id",
+            "type": "string"
+          },
+          {
+            "name": "recipientType",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "description": "Recipient type",
+            "x-ms-summary": "Recipient type",
+            "x-ms-dynamic-values": {
+              "operationId": "StaticResponseForRecipientTypes",
+              "value-collection": "recipientTypes",
+              "value-path": "type",
+              "value-title": "name"
+            }
+          },
+          {
+            "name": "clientUserId",
+            "in": "query",
+            "description": "Client user ID for embedded signer",
+            "required": false,
+            "x-ms-summary": "Client User ID",
+            "x-ms-visibility": "advanced",
+            "type": "string"
+          },
+          {
+            "name": "routingOrder",
+            "in": "query",
+            "description": "The signing order of the recipient.",
+            "x-ms-summary": "Signing order",
+            "x-ms-visibility": "advanced",
+            "type": "string"
+          },
+          {
+            "name": "emailNotificationLanguage",
+            "in": "query",
+            "description": "Language for the email notification.",
+            "x-ms-summary": "Email notification language",
+            "x-ms-visibility": "advanced",
+            "type": "string",
+            "enum": [
+              "Arabic (ar)",
+              "Bulgarian (bg)",
+              "Czech (cs)",
+              "Chinese Simplified (zh_CN)",
+              "Chinese Traditional (zh_TW)",
+              "Croatian (hr)",
+              "Danish (da)",
+              "Dutch (nl)",
+              "English US (en)",
+              "English UK (en_GB)",
+              "Estonian (et)",
+              "Farsi (fa)",
+              "Finnish (fi)",
+              "French (fr)",
+              "French Canada (fr_CA)",
+              "German (de)",
+              "Greek (el)",
+              "Hebrew (he)",
+              "Hindi (hi)",
+              "Hungarian (hu)",
+              "Bahasa Indonesia (id)",
+              "Italian (it)",
+              "Japanese (ja)",
+              "Korean (ko)",
+              "Latvian (lv)",
+              "Lithuanian (lt)",
+              "Bahasa Malay (ms)",
+              "Norwegian (no)",
+              "Polish (pl)",
+              "Portuguese (pt)",
+              "Portuguese Brasil (pt_BR)",
+              "Romanian (ro)",
+              "Russian (ru)",
+              "Serbian (sr)",
+              "Slovak (sk)",
+              "Slovenian (sl)",
+              "Spanish (es)",
+              "Spanish Latin America (es_MX)",
+              "Swedish (sv)",
+              "Thai (th)",
+              "Turkish (tr)",
+              "Ukranian (uk)",
+              "Vietnamese (vi)",
+              "Armenian (hy)"
+            ]
+          },
+          {
+            "name": "emailNotificationSubject",
+            "in": "query",
+            "description": "Subject of the email notification.",
+            "x-ms-summary": "Email notification subject",
+            "x-ms-visibility": "advanced",
+            "type": "string"
+          },
+          {
+            "name": "emailNotificationBody",
+            "in": "query",
+            "description": "Body of the email notification.",
+            "x-ms-summary": "Email notification body",
+            "x-ms-visibility": "advanced",
+            "type": "string"
+          },
+          {
+            "name": "note",
+            "in": "query",
+            "description": "Custom note for the recipient.",
+            "x-ms-summary": "Note",
+            "x-ms-visibility": "advanced",
+            "type": "string"
+          },
+          {
+            "name": "roleName",
+            "in": "query",
+            "description": "Role name associated with the recipient.",
+            "x-ms-summary": "Role name",
+            "x-ms-visibility": "advanced",
+            "type": "string"
+          },
+          {
+            "name": "countryCode",
+            "in": "query",
+            "description": "For SMS notifications, the country code, without leading + sign.",
+            "x-ms-summary": "SMS Country Code",
+            "x-ms-visibility": "advanced",
+            "type": "integer"
+          },
+          {
+            "name": "phoneNumber",
+            "in": "query",
+            "description": " For SMS notifications, the phone number without the country code.",
+            "x-ms-summary": "SMS Phone Number",
+            "x-ms-visibility": "advanced",
+            "type": "integer"
+          },
+          {
+            "name": "additionalRecipientParams",
+            "in": "body",
+            "description": "Details for selected recipient type.",
+            "x-ms-visibility": "advanced",
+            "schema": {
+              "$ref": "#/definitions/AdditionalRecipientParamsSchema"
+            },
+            "x-ms-summary": "details for selected recipient type"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Signer"
+            }
+          }
+        },
+        "deprecated": false,
+        "x-ms-visibility": "important",
+        "x-ms-no-generic-test": true
+      },
+    },
     "/login_information": {
       "get": {
         "tags": [

certified-connectors/DocuSignDemo/script.csx

@@ -1063,6 +1063,7 @@ public class Script : ScriptBase
 
     var uriBuilder = new UriBuilder(this.Context.Request.RequestUri);
     uriBuilder.Path = uriBuilder.Path.Replace("/recipients/addRecipientV2", "/recipients");
+    uriBuilder.Path = uriBuilder.Path.Replace("/recipients/updateRecipient", "/recipients");
     this.Context.Request.RequestUri = uriBuilder.Uri;
 
     return body;
@@ -1206,8 +1207,15 @@ public class Script : ScriptBase
   {
     var query = HttpUtility.ParseQueryString(this.Context.Request.RequestUri.Query);
 
-    signers[0]["recipientId"] = GenerateId();
-    
+    if (!string.IsNullOrEmpty(query.Get("recipientId")))
+    {
+      signers[0]["recipientId"] = query.Get("recipientId");
+    }
+    else
+    {
+      signers[0]["recipientId"] = GenerateId();
+    }
+
     if (!string.IsNullOrEmpty(query.Get("routingOrder")))
     {
       signers[0]["routingOrder"] = query.Get("routingOrder");
@@ -1275,7 +1283,6 @@ public class Script : ScriptBase
   {
     var query = HttpUtility.ParseQueryString(this.Context.Request.RequestUri.Query);
     var recipientType = query.Get("recipientType");
-    signers[0]["recipientId"] = GenerateId();
 
     if (recipientType.Equals("inPersonSigners"))
     {
@@ -1459,7 +1466,8 @@ public class Script : ScriptBase
       await this.TransformRequestJsonBody(this.AddRecipientToEnvelopeBodyTransformation).ConfigureAwait(false);
     }
 
-    if ("AddRecipientToEnvelopeV2".Equals(this.Context.OperationId, StringComparison.OrdinalIgnoreCase))
+    if ("AddRecipientToEnvelopeV2".Equals(this.Context.OperationId, StringComparison.OrdinalIgnoreCase) ||
+        "UpdateEnvelopeRecipient".Equals(this.Context.OperationId, StringComparison.OrdinalIgnoreCase))
     {
       await this.TransformRequestJsonBody(this.AddRecipientToEnvelopeV2BodyTransformation).ConfigureAwait(false);
     }