多个文档和签名者,嵌入式签名中的文档顺序不正确

Multiple documents & signers, document order incorrect in embedded signing

我有一个装有多个文件和签名者的信封。

所有签名者都已为第一个文档(documentId“1”,文档数组中的第一个)共享锁定的 textTab,但此处没有签名、签名日期或全名选项卡。

此外,所有签名者都有非共享、锁定的文本标签,以及此处的签名、签名日期和正好 1 个其他文档(签名页)的全名标签。

我已启用 enforceSignerVisibilty。

除了在嵌入式签名 UI 中,一切都按预期工作,签名者会立即显示需要签名的文档,跳过第一个文档。但是,第一个文档在最终审阅步骤中首先包含,并且在为该签名者下载组合文档时也首先包含。

如何在嵌入式签名 UI 中获得第一个文档?我已经尝试将其作为 signerMustAcknowledge 的模态显示和 'view_read_accept' 的补充文档。 UI 和流程运行良好,但未填写文本选项卡。

* 更新 * 我花了很多时间尝试不同的设置和文档组合,发现文档签名 API 中存在意想不到的未记录的异常情况导致了此行为:

1 - 第一个文档是 PDF 文档,但其他文档是 HTML。我们必须为所有文档使用 PDF。通过为第一个文档设置 htmlDefinition = { source: 'document' } 和为其他文档设置 HTML 来使用转换为 HTML 的 PDF 无效。所以现在我们为签名页生成 PDF,而不是简单地编码 HTML.

2 - 我们使用 anchorText 导致选项卡的 documentId 被忽略!所以我们不得不为不同的文档使用不同的 anchorText 值,即使它们在逻辑上代表相同的东西!。使用 x、y 和 pageNumber 坐标需要大量工作才能与文档更改保持同步;它使代码非常脆弱。我们还必须将 anchorCaseSensitive 和 anchorMatchWholeWord 都设置为 'true'.

您的 DS 帐户在帐户级别有一个锚定字符串填充范围的设置,默认情况下它是信封范围。因此,如果信封中的两个文档都存在相同的锚字符串,则 DocuSign 将为每个文档上的每个签名者应用制表符。要解决此问题,您需要请求 DocuSign 支持或您的 DocuSign 客户经理将范围从 DocuSign 的后端内部管理工具更改为文档而不是信封。

将范围设置为 Document 后,您可以为每个 String 添加 documentId 和 anchorString,它只会为该特定签名者应用制表符。