使用复合模板

Using a composite template

我想弄清楚何时需要为服务器模板设置顺序#,以及是否需要为复合模板设置相同的顺序。这是我要解决的问题:我的信封将有 3 或 4 个文件,每个文件都有自己的模板。我将为每个文档提供内联模板,每个文档上的签名者角色都相同。如果我在信封中有多个 document/template 对,是否意味着我必须使用复合模板?例如,如果我为一个文档使用多个服务器模板,那么顺序是否重要?我只是需要更多地了解这些复合模板。

If I have multiple document/template pairs in an envelope, does that mean I have to use a composite template?

是的。

If I am using multiple server templates for a doc, for example, is that when the sequence order is important?

抱歉,我还不是这方面的专家。有几个关于合成模板的 Whosebug 问题,请检查它们。

此外,最好尝试一下测试信封。如果它没有按您预期的方式工作,请提出一个关于您的代码的新的、具体的问题。

您必须使用复合模板。信封中文件的顺序将遵循 compositeTemplate 元素的结构顺序。

每个 compositeTemplate 元素有一个或多个 serverTemplates and/or inlineTemplates。这些数组的每个模板元素都有一个带有整数值的 sequence 元素。这些值应在该组合中形成一个序列,并确定为组合导出文档的顺序以及为其他信封元素发生的覆盖顺序。

通过 composite::document 节点显式提供由单个组合贡献给信封的文档,或者如果不存在,则由组合中可以贡献文档的第一个(最低序列值)模板提供,例如 serverTemplate 文档或 inlineTemplate::documents 节点。

覆盖信封元素遵循 "last in gets final overwrite" 方法。因此,最后一个(最高)sequence 模板中指定的值会覆盖所有先前设置的值。