无法使用 CreateEnvelopeFromTemplates 将多个模板应用于 DocuSign 信封中的单个文档答案

【问题标题】：Unable to Apply Multiple Templates to a Single Document in a DocuSign Envelope using CreateEnvelopeFromTemplates无法使用 CreateEnvelopeFromTemplates 将多个模板应用于 DocuSign 信封中的单个文档
【发布时间】：2013-09-02 18:29:35
【问题描述】：

我已在 J2EE 应用程序中成功使用 DocuSign 嵌入式签名，使用 createEnvelopeFromTemplates SOAP API、1 个模板和 1 个文档在信封中为 2 个签名者创建 1 个文档。

现在我正在实施一个有两个以上签名者的案例。文档中包含一些复选框。复选框将由其中一位签名者检查。并非所有签名者都对每个文档进行签名，并且在创建信封时根据实际存在的签名者确定哪个签名者检查复选框。

我尝试通过使用一组模板来实现这个案例：

所有可能签名的模板
为每个可以填写复选框的可能签名者标记的模板。

在创建信封时，我的网站已收集信息以了解存在哪些签名者，以及哪些签名者将填写复选框。在调用 DocuSign 以创建信封时引用了适当的模板，并分配了适当的角色。问题是当使用 createEnvelopeFromTemplates 操作指定多个模板时，每个 TemplateReference 对象都需要一个文档。我不知道如何告诉 API 将多个模板应用到同一个文档，所以我最终会在信封中得到一个文档。

阅读 DocuSign 文档，似乎将 createEnvelopesFromTemplatesAndForms 与 CompositeTemplates 结合使用可能有效，但我更愿意使用更简单的 CreateEnvelopeFromTemplates。有没有办法使用 CreateEnvelopeFromTemplates 将多个模板应用于单个文档？

谢谢，马克

【问题讨论】：

CreateEnvelopeFromTemplatesAndForms 对我们来说不是一个好的解决方案，因为我们必须在运行时以编程方式分配 DocuSign 选项卡。如果您已将选项卡分配给模板上的锚文本但锚文本未出现在文档中，则此 API 调用会引发错误。我们的模板中有许多选项卡被锚定到可能会或可能不会出现在实际文档中的锚文本。我们有许多使用相同模板的文档变体。切换到 CreateEnvelopeFromTemplatesAndForms 需要重新设计我们的流程。谢谢，马克

标签： docusignapi

【解决方案1】：

您需要使用 CompositeTemplates 来解决此问题。您正在进行的 CreateEnvelopeFromTemplates() 调用将所谓的 ServerTemplates 添加到您的信封中，并且由于每个服务器模板都包含一个文档（即，您无法在 DocuSign 控制台中保存设计时模板不提供文档）每次将服务器模板添加到信封时，它也会添加文档。

使用 CompositeTemplates，您可以将 ServerTemplates 和 InlineTemplates 添加到信封中，这意味着您可以从包含文档的模板开始，然后使用第二个（内联）模板，不包括其文档。因此，您应该改为进行的 SOAP 调用是

CreateEnvelopeFromTemplatesAndForms()

并且使用 RoleName 属性，您可以将收件人分配给您在设计时已经创建的模板角色。

我将建议通过 API Explorer 进行测试，但请记住您使用的是 SOAP API 而不是 REST，这是用于测试 REST，因此您最好的选择可能是 SOAP 文档和在 SOAP 中找到的示例GithUb 上的 SDK：

SDK 中有示例 CreateEnvelopeFromTemplatesAndForms() 调用说明如何进行调用。

【讨论】：

【解决方案2】：

我们找到了一个似乎可行的解决方案。我们仍在使用 CreateEnvelopeFromTemplates 操作，但我们将模板合并为一个并创建了一个新角色“问题回答者”，并将所有复选框分配给该角色。在信封创建时，当我们指定角色分配时，我们将适当的签名者的 ID 指定给签名角色和“问题回答者”角色。

虽然我们没有找到使用 CreateEnvelopeFromTemplates 将多个模板应用于单个文档的方法，但上述解决方案解决了我们的问题。

谢谢，马克

【讨论】：