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

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

现在我正在实施一个有两个以上签名者的案例。文档中包含一些复选框。支票箱应由其中一名签字人检查。并不是所有的签名者都在每个文档上签名，而哪个签名者检查复选框是在信封创建时根据实际存在的签名者确定的

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

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

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

在阅读DocuSign文档时，似乎可以将createEnvelopesFromTemplates和Forms与CompositeTemplates一起使用，但我更愿意使用更简单的CreateEnvelopeFromTemplates。是否有一种方法可以使用CreateEnvelopeFromTemplates将多个模板应用于单个文档

---

谢谢，Mark

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

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

CreateEnvelopeFromTemplatesAndForms()

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

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

---

SDK中的CreateEnvelopeFromTemplates和Forms（）调用示例演示了如何进行调用。

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

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

---

谢谢，Mark

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