Docusign 为多个收件人转换 Pdf 字段？

Question

我看到 DocuSign API 可以自动转换 pdf 字段并将其分配给单个默认收件人 (Docusign Transform Pdf Fields For single recipient?)。

是否可以为多个收件人进行分配？

我希望利用自动转换功能，但同时在信封创建期间将不同的 pdf 字段分配给不同的收件人。

谢谢。

Answer 1

以下示例使用 REST API 使用 base64 编码的 pdfBytes 创建一个信封，该信封表示一个包含多个 adobe 表单字段的 PDF 文档：选项字段、复选框、签名字段。我们使用 adobe 字段的名称将此字段映射到为每个收件人创建的 DocuSign 标签。

请注意，这里的关键是为每个 PDF 表单字段命名为使用通配符可以轻松分配给收件人的格式。

有关用于将 adobe 字段与 DS 字段匹配的规则，请参阅文档参数（下注）。我们将转换所有 adobe 字段并将它们分配给两个收件人，为此我们将创建每个签名者和标签，我们将绑定通过在 tabLabel 上使用通配符创建的每个 DS 标签的方式。我们还将为一些数据字段设置值，我们将选择在父项中分组的单选按钮，并选择我们因转换这些字段而创建的复选框。

HTTP Headers:

Accept: application/json

X-DocuSign-Authentication: {"Username": "your_sender@mail", "Password":"your_password",      "IntegratorKey":"your_integration_key"}

Content-Type: multipart/form-data; boundary=e6e95273-cafb-4dbf-86b8-a1c0ed85b5c5

Resource: https://{env}.docusign.net/restapi/{version}/accounts/{accountId}/envelopes
Method: POST

Payload:

  --e6e95273-cafb-4dbf-86b8-a1c0ed85b5c5
  Content-Type: application/json
  Content-Disposition: form-data

  {
     "status":"sent",
     "emailSubject":"Test transforming pdf forms and assigning them to each user",
     "compositeTemplates":[
        {
           "inlineTemplates":[
              {
                 "sequence":1,
                 "recipients":{
                    "signers":[
                       {
                          "email":"[replace this with a valid email]",
                          "name":"Signer One",
                          "recipientId":"1",
                          "routingOrder":"1",
                          "tabs":{
                             "textTabs":[
                                {
                                   "tabLabel":"PrimarySigner\\*",
                                   "value":"Signer One"
                                }
                             ],
                             "checkboxTabs":[
                                {
                                   "tabLabel":"PrimarySigner\\*",
                                   "selected":true
                                }
                             ],
                             "signHereTabs":[
                                {
                                   "tabLabel":"PrimarySigner\\*"
                                }
                             ],
                             "dateSignedTabs":[
                                {
                                   "tabLabel":"PrimarySigner\\*"
                                }
                             ],
                             "radioGroupTabs":[
                                {
                                   "groupName":"PrimarySigner\\*",
                                   "radios":[
                                      {
                                         "value":"M",
                                         "selected":true
                                      }
                                   ]
                                }
                             ]
                          }
                       },
                       {
                          "email":"[replace this with a valid email]",
                          "name":"Signer Two",
                          "recipientId":"2",
                          "routingOrder":"2",
                          "tabs":{
                             "textTabs":[
                                {
                                   "tabLabel":"SecondarySigner\\*",
                                   "value":"Secondary One"
                                }
                             ],
                             "checkboxTabs":[
                                {
                                   "tabLabel":"SecondarySigner\\*",
                                   "selected":true
                                }
                             ],
                             "signHereTabs":[
                                {
                                   "tabLabel":"SecondarySigner\\*"
                                }
                             ],
                             "dateSignedTabs":[
                                {
                                   "tabLabel":"SecondarySigner\\*"
                                }
                             ],
                             "radioGroupTabs":[
                                {
                                   "groupName":"SecondarySigner\\*",
                                   "radios":[
                                      {
                                         "value":"F",
                                         "selected":true
                                      }
                                   ]
                                }
                             ]
                          }
                       }
                    ]
                 }
              }
           ],
           "document":{
              "documentId":1,
              "name":"test.pdf",
              "transformPdfFields":true
           }
        }
     ]
  }

  --e6e95273-cafb-4dbf-86b8-a1c0ed85b5c5
  Content-Type: application/pdf
  Content-Disposition: file; filename="test1.pdf"; documentId=1
  Content-Transfer-Encoding: base64

  [replace this with a base64 encoded]

  --e6e95273-cafb-4dbf-86b8-a1c0ed85b5c5--