多个签名者、PDF转换/合成模板和通配符 [英] Multiple signers, PDF Transform/CompositeTemplate and wildcards

问题描述

我知道我可以使用PDF字段转换和复合模板(我实际上使用的是C#SDK，因此实际的JSON不如使用SDK知道这是可能的)来让收件人对名称以PrimarySigner开头的PDF表单(不是DocuSign模板)上的所有签名选项卡进行签名

"tabs":{
   "signHereTabs":[
   {
      "tabLabel":"PrimarySigner\*"
   }
]

假设一个文档有三组签名字段。签名者1获得PrimarySigner，签名者2获得Second darySigner，并且根据信封的上下文，签名者1或签名者2可能获得TertiarySigner。在签名者1获得这些签名字段的情况下，我可以为一个签名者添加多个通配符吗？例如：

"tabs":{
   "signHereTabs":[
   {
      "tabLabel":"PrimarySigner\*"
   }
   ],
   "signHereTabs":[
   {
      "tabLabel":"TertiarySigner\*"
   }
   ]
}

更新：我想我已经使用C#SDK实现了这一点。然而，对于两个签名者来说，签名标签正在消失；当他们查看文档时，他们得到的是自由形式而不是直接签名体验。我要发送的PDF文档有两个PDF签名域，名为DocuSignHere_Signer1_1和DocuSignSignHere_Signer2_1。我已经仔细检查了显而易见的内容，如设置TransformPDFFields等。PDF表单字段名称的两端都将使用通配符，对吗？

这里是序列化信封的JSON。

{
   "compositeTemplates":[
      {
         "inlineTemplates":[
            {
               "documents":[
                  {
                     "documentBase64":"redacted",
                     "documentId":"1",
                     "name":"TestPDFForm.pdf",
                     "transformPdfFields":"true"
                  }
               ],
               "recipients":{
                  "signers":[
                     {
                        "email":"[e-mail]",
                        "name":"Test Signer 1",
                        "recipientId":"1",
                        "tabs":{
                           "signHereTabs":[
                              {
                                 "tabLabel":"DocuSignSignHere_Signer1\*"
                              }
                           ]
                        }
                     },
                     {
                        "email":"[e-mail]",
                        "name":"Test Signer 2",
                        "recipientId":"2",
                        "tabs":{
                           "signHereTabs":[
                              {
                                 "tabLabel":"DocuSignSignHere_Signer2\*"
                              }
                           ]
                        }
                     }
                  ]
               },
               "sequence":"1"
            }
         ]
      }
   ],
   "customFields":{
      "textCustomFields":[
         {
            "name":"ClientId",
            "value":"A:1!!D:1!!T:1!!UserId:123!!C:10BD32B131C5ECE3"
         }
      ]
   },
   "documents":[

   ],
   "emailSubject":"Test Email",
   "eventNotification":{
      "envelopeEvents":[
         {
            "envelopeEventStatusCode":"completed"
         }
      ],
      "includeCertificateOfCompletion":"true",
      "includeCertificateWithSoap":"false",
      "includeDocumentFields":"true",
      "includeSenderAccountAsCustomField":"true",
      "includeTimeZone":"true",
      "requireAcknowledgment":"true",
      "signMessageWithX509Cert":"false",
      "url":"https://test.test.com/documentcallback.aspx",
      "useSoapInterface":"false"
   },
   "status":"sent"
}

推荐答案

是，您可以使用通配符将多个字段分配给单个签名者。

在您的示例中，您应该将通配符前缀(\*)移到beginning of the tabLabel处。您还可以将signHereTabs移动到单个数组中。

这里有一个PostEnvelope示例请求。请参阅完整示例here

POST/v2/Accounts/{accountId}/信封

 {
     "compositeTemplates": [
         {
             "inlineTemplates": [
                 {
                     "sequence": "1",
                     "recipients": {
                         "signers": [
                             {
                                 "name": "Jane Doe",
                                 "email": "[e-mail]",
                                 "recipientId": "1",
                                 "tabs": {
                                     "signHereTabs": [
                                         {
                                             "tabLabel": "\*PrimarySigner"
                                         },
                                         {
                                             "tabLabel": "\*TertiarySigner"
                                         }
                                     ]
                                 }
                             },
                             {
                                 "name": "Bob Doe",
                                 "email": "[e-mail]",
                                 "recipientId": "2",
                                 "tabs": {
                                     "signHereTabs": [
                                         {
                                             "tabLabel": "\*SecondarySigner"
                                         }
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ],
             "document": {
                 "documentId": "1",
                 "name": "Doc with Fields",
                 "transformPdfFields": "true",
                 "fileExtension": "pdf",
                 "documentBase64": ""
             }
         }
     ],
     "emailSubject": "Doc with form fields",
     "status": "sent",
 }

这篇关于多个签名者、PDF转换/合成模板和通配符的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！