Docusignapi 使用docusignrestapi将文档附加到SignerAttachmentTab

我们已经定义了一个模板，将由我们的客户填写和签署。在这个模板中，我们有一些预先填充的字段，以及一些我们将附加的文档。客户将填写其他字段并附加更多文档。我们正在使用RESTAPI生成签名请求。我们能够生成正确的REST请求以填充模板中的选项卡，设置收件人并成功发送签名请求。所有这些都很有效。但是现在我们试图将一个文档附加到模板中相应的SignerAttachmentTab，而我们无法让REST接受它

我们尝试过使用Documents字段，但这似乎不适用于模板。我们创建了一个复合模板，然后为文档定义了一个文档，为模板本身定义了一个服务器模板，并定义了一个内联模板来包含我们要填充的选项卡数据。这会不断生成有关选项卡页码不正确的错误。我们尝试了不同的价值观，我们查看了所有与将文档附加到模板相关的论坛帖子和文档，但没有一个有效

对于指定要上载的文件的文档，请设置文档ID和名称。在服务器模板中，我们指定模板ID。在内联模板中，我们创建一个收件人，设置他们的信息，用数据构建信封选项卡，然后为文档添加SignerAttachmentTab。在此选项卡中，我们将文档ID设置为与文档元素中的文档ID相匹配。我们将tabLabel设置为模板本身中使用的标签。我们已尝试设置页码，但这并没有改变任何事情。我们所需要的只是将文档发送给客户。当用户打开它时，他们可以双击附件字段并查看我们试图发送的文档

我正在尝试使用配方资源管理器使用原始REST使其正常工作，但由于出现TAB_PAGENUMBER_IS_NOT_IN_DOCUMENT错误而一直失败。似乎文档优先于模板。不幸的是，除了在服务器和内联模板上设置序列之外，我无法在编辑器中更改模板的顺序。下面是使用DocuSign的测试系统生成的请求

{ 
    "compositeTemplates":[{
       "document":   {
           "documentBase64":"<Base64BytesHere>",
           "documentId":"2",
           "name":"Test.pdf"
       },
       "inlineTemplates":[{
           "recipients":{
               "signers":[{
                     "email":"abc@def.org",
                     "name":"Person",
                     "recipientId":"1",
                     "roleName":"Sender 1",
                     "tabs":{
                          "signerAttachmentTabs":[{
                               "documentId":"2",
                               "tabLabel":"MyAttachment"
                          }],
                          "textTabs":[{
                               "tabLabel":"someText",
                               "value":"Value1" }
                          ]}
                 }]},
             "sequence":"2"
         }],
         "serverTemplates":[{
               "sequence":"1",
               "templateId":"guid}]
             }],
         "emailBlurb":"A message",
         "emailSubject":"Test",
         "status":"sent"
}

{
“compositeTemplates”：[{
“文件”：{
“documentBase64”：“，
“文档ID”：“2”，
“名称”：“Test.pdf”
},
“inlineTemplates”：[{
“收件人”：{
“签署人”：[{
“电子邮件”：abc@def.org",
“姓名”：“人”，
“接收方ID”：“1”，
“roleName”：“发件人1”，
“选项卡”：{
“签名附件选项卡”：[{
“文档ID”：“2”，
“tabLabel”：“我的附件”
}],
“文本选项卡”：[{
“tabLabel”：“someText”，
“值”：“值1”}
]}
}]},
“顺序”：“2”
}],
“服务器模板”：[{
“顺序”：“1”，
“templateId”：“guid}]
}],
“emailBlurb”：“一条消息”，
“邮件主题”：“测试”，
“状态”：“已发送”
}

我查看了论坛中的现有帖子，要么它们不适用于我的案例，要么它们没有尝试将文档附加到模板中，只是将它们作为模板之外的文档包含进来。

Re:

但是现在我们试图将一个文档附加到模板中相应的SignerAttachmentTab，而我们无法让REST接受它

您正在尝试使用API将文档添加到SignerAttachmentTab

这是不支持的。只有签名者自己将文档添加到SignerAttachmentTab。API无法为他们这样做

您是否希望确保签名者将文档附加（上载）到信封作为签名仪式的一部分？您可以将选项卡设置为非可选（必需）。但这不会检查附加文件的内容

您可以使用web钩子/连接来检查附加的文件，如果没有附加正确的文件，则为签名者生成另一个信封。

Re:

但是现在我们试图将一个文档附加到模板中相应的SignerAttachmentTab，而我们无法让REST接受它

您正在尝试使用API将文档添加到SignerAttachmentTab

这是不支持的。只有签名者自己将文档添加到SignerAttachmentTab。API无法为他们这样做

您是否希望确保签名者将文档附加（上载）到信封作为签名仪式的一部分？您可以将选项卡设置为非可选（必需）。但这不会检查附加文件的内容

---

您可以使用web钩子/连接来检查文件如果没有附加正确的文件，请为签名者生成另一个信封。

我发现我做错了什么。对于没有附件的模板，我使用的是TemplateRole和EnvelopeTabs。但是对于附件，尝试包含任何文档都会导致文档覆盖模板。因此我切换到composite模板，包含用于模板和数据的服务器模板和内联模板。尝试在允许添加文档的各个区域中以各种组合添加文档通常会导致发送请求，但没有文档

最终的解决方案是返回到最初的TemplateRole方法，但将信封创建为草稿。创建草稿信封后，我可以将文档添加到信封中。但不幸的是，要发送信封，您必须重新连接收件人。我希望将其清理干净，否则它现在对我有效

I菲古