Docusignapi 何时使用Docusign TemplateRole与签名者

我试图看看在什么情况下使用TemplateRole比使用签名者更好。对于我的应用程序，我们的结构使文档和模板之间有一对一的关系。我们将有像Buyer1和Seller1这样的收件人，我们将使用锚定标签自动放置我们的签名标签。我看到了签名者和TemplateRoles之间的一个区别，签名者可以有一张私人便条。我只想针对我的特殊情况使用正确类型的收件人。

使用模板可以让管理员（使用webtool）更新模板，而无需更新代码

例如，如果您想添加另一个文本字段，可以通过模板完成，而无需更改代码

将模板视为文档的编程说明，包括选项卡位置和设置。通过webtool添加“程序”比通过API指定所有内容更容易。尽管两种情况的结果都是一样的

我相信，如果您还提供了roleName字段，则可以为收件人提供一封私人电子邮件。为什么你认为你不能

---

请记住，您可以通过在信封中合成模板来“覆盖”模板值/模板编程：创建呼叫。

使用模板使管理员能够更新模板（使用webtool），而无需更新代码

例如，如果您想添加另一个文本字段，可以通过模板完成，而无需更改代码

将模板视为文档的编程说明，包括选项卡位置和设置。通过webtool添加“程序”比通过API指定所有内容更容易。尽管两种情况的结果都是一样的

我相信，如果您还提供了roleName字段，则可以为收件人提供一封私人电子邮件。为什么你认为你不能

请记住，您可以通过在信封中合成模板来“覆盖”模板值/模板编程：创建呼叫。

“签名者”是一种收件人类型。TemplateRole是模板中收件人的占位符。TemplateRole（作为未来收件人的查询）具有任何收件人属性，但可以省略收件人名称和收件人电子邮件。创建实际信封时，需要指定收件人。将收件人映射到TemplateRole，以便用实际收件人替换模板的角色

例如，您的模板可能有多个收件人，您希望在创建信封时将这些收件人动态分配给其他人。您可以将角色添加到模板中，使用所有常用的收件人属性来指定工作流（如routingOrder to sequence Recipients）、将操作（选项卡）分配给签名者类型的收件人等。在信封创建时，API调用指定收件者，然后使用它们来完成TemplateRoles。

“签名者”是收件人的一种类型。TemplateRole是模板中收件人的占位符。TemplateRole（作为未来收件人的查询）具有任何收件人属性，但可以省略收件人名称和收件人电子邮件。创建实际信封时，需要指定收件人。将收件人映射到TemplateRole，以便用实际收件人替换模板的角色

---

例如，您的模板可能有多个收件人，您希望在创建信封时将这些收件人动态分配给其他人。您可以将角色添加到模板中，使用所有常用的收件人属性在信封创建时指定工作流（如routingOrder to sequence Recipients）、将操作（选项卡）分配给签名者类型的收件人等，您的API调用指定了收件人，然后使用他们来实现TemplateRole。

我在TemplateRole上没有看到Notes属性。不过我确实是为一个签名者而看的。我没有把Note看作TemplateRole上的属性。不过，我确实看到了一个签名者。