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

Question

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

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

我试图通过使用一组模板来实现这种情况：

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

在信封创建时，我的网站收集了信息，以了解哪些签名者在场，以及哪位签名者将填写复选框。在调用DocuSign时引用适当的模板以创建信封，并分配适当的角色。问题是，使用createEnvelopeFromTemplates操作指定多个模板时，每个TemplateReference对象都需要一个文档。我无法弄清楚如何告诉API将多个模板应用于同一个文档，因此我最终会在信封中包含一个文档。

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

谢谢，Mark

Answer 1

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

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

CreateEnvelopeFromTemplatesAndForms()

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

我打算建议通过API Explorer对此进行测试，但记得你使用的是SOAP API而不是REST，而是用于REST测试，所以最好的选择是SOAP文档和在GithUb上的SOAP SDK：

• DocuSign SOAP SDK
• SOAP Guide - CreateEnvelopeFromTemplatesAndForms

SDK中有一些示例CreateEnvelopeFromTemplatesAndForms（）调用，用于显示如何进行调用。

Answer 2

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

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

谢谢，Mark