何时使用Docusign TemplateRole与Signer

Question

我试图看看在哪种情况下最好使用TemplateRole而不是Signer。对于我的应用程序，我们的结构在文档和模板之间具有一对一的结构。我们将拥有像Buyer1和Seller1这样的收件人，我们将使用锚标签让我们的签名选项卡自动进行。我看到签名者和TemplateRoles之间的区别在于签名者可以拥有私人笔记。我只是想在我的特定情况下使用正确类型的收件人。

Answer 1

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

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

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

我相信您可以为您还提供roleName字段的收件人添加私人电子邮件。为什么你认为你不能？

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

Answer 2

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

因此，例如，您的模板可能有多个收件人，您希望在创建信封时动态地将其分配给人员。您可以将角色添加到模板，使用所有常用的Recipient属性来指定工作流（例如routingOrder来对收件人进行排序），将操作（Tabs）分配给签名者类型的收件人等。在信封创建时，您的API调用指定收件人然后使用它们来完成TemplateRoles。