文档模板的全局选项卡

Question

有没有办法在没有收件人声明的情况下为文档分配标签？

情况：我们希望为员工应用程序创建一个模板，然后使用API​​填充字段，分配收件人并嵌入以进行签名。

当我创建没有收件人的模板时，它不允许我放置任何标签。鉴于我在调用API之前不知道收件人，这是否意味着我无法在此之前放置标签？我真的不想动态地放置50个标签。

提前致谢。 大通

Answer 1

DocuSign选项卡始终与给定的收件人有关，而不是文档本身，但我相信您仍然可以完成此工作流程。如果您通过DocuSign控制台创建模板，则可以在不提供任何收件人信息（即名称或电子邮件）的情况下添加模板角色。之后，当您通过签名请求API调用引用此模板时，您可以在请求中提供实际的收件人姓名和电子邮件，并通过

将它们映射到您已配置的信封标签

roleName 

每个收件人的

属性。

第一个DocuSign API演练的代码演示了如何只使用一个角色来完成此操作，但请注意，这只是一个示例，您可以拥有多个角色。

DocuSign API Walkthroughs

从高层次来看，这些是你想要采取的步骤：

1. 在DocuSign控制台中创建模板。
2. 添加文档，然后添加至少一个收件人，但只填写角色字段。
3. 现在，在您的文档中，您将看到可以在该角色下添加所需的任何标签。
4. 保存模板。
5. 进行API调用以请求签名，该签名引用templateId并为您的收件人提供 roleName 参数。此roleName值应与您在步骤2中与模板一起保存的角色匹配。

例如，如果您将角色命名为 Signer1 ，则您的请求正文（采用JSON格式）可能如下所示：

{
"accountId": "123456",
"emailSubject": "DocuSign API Call - Signature Request from Template",
"emailBlurb": "Sample email body",
"templateId": "B977F511-CAB0-...................",
"templateRoles": [
    {
        "roleName": "Signer1",
        "email": "test@docusign.com",
        "name": "John Doe"
    }
],
"status": "sent"

}