复合模板 - signHere 选项卡全部出现在第一个文档上

Composite Template - signHere tabs all appear on the first document

我定义了两个模板,每个模板都有一个 primary.account.holder 角色,并且关联的 signHere 选项卡放置在每个模板的适当位置。如果我 运行 每个单独一个,即创建一个信封并添加我的收件人,那么标签就会按照我的预期放置。

第一个模板的文档有 11 页,第 10 页有一个 signHere 选项卡。第二个模板的文档有 4 页长,最后一页有一个 signHere 标签。

我想做的是创建一个包含这两个模板的信封,只有一个签名者。为此,我使用上面的两个模板构建了一个复合模板。

我运行遇到了以下问题:文件在信封中的顺序正确,但是标签都出现在第一个文件上,而第二个文件根本没有任何标签。 (第一个文档在第 10 页上应该有一个 signHere 选项卡,但它在第 4 页上也有一个,它应该在第二个文档中,第二个文档没有选项卡。)

下面是我提交的信封。

{
    "compositeTemplates": [
        {
            "document": {
                "documentBase64": "...",
                "documentId": "81",
                "fileExtension": "pdf",
                "name": "file-one.pdf",
                "order": "1"
            },
            "inlineTemplates": [
                {
                    "recipients": {
                        "signers": [
                            {
                                "email": "docusign@example.com",
                                "name": "Doe, Jane",
                                "recipientId": "35916331",
                                "roleName": "primary.account.holder",
                                "routingOrder": "1"
                            }
                        ]
                    },
                    "sequence": "2"
                }
            ],
            "serverTemplates": [
                {
                    "sequence": "1",
                    "templateId": "0058ab16-22e7-4877-ace1-2022bf8566b8"
                }
            ]
        },
        {
            "document": {
                "documentBase64": "...",
                "documentId": "80",
                "fileExtension": "pdf",
                "name": "file-two.pdf",
                "order": "2"
            },
            "inlineTemplates": [
                {
                    "recipients": {
                        "signers": [
                            {
                                "email": "docusign@example.com",
                                "name": "Doe, Jane",
                                "recipientId": "35916331",
                                "roleName": "primary.account.holder",
                                "routingOrder": "1"
                            }
                        ]
                    },
                    "sequence": "2"
                }
            ],
            "serverTemplates": [
                {
                    "sequence": "1",
                    "templateId": "7b1282bf-051b-47b8-bd31-473c1423be4d"
                }
            ]
        }
    ],
    "emailSubject": "Please sign this document set.",
    "status": "sent"
}

我对两个内联模板使用相同的签名者和相同的 recipientId,但我也尝试过使用不同的 recipientId,但没有成功。(编辑 - 不相关)

我不清楚我做错了什么。我已经完成了一些复合模板文档,但我还没有看到任何明显与我的信封有关的错误。我怎样才能让标签放在每个文档上,而不仅仅是第一个?

更新一个

和我的问题类似。发布者找到的解决方案分为两部分:1) 内联模板需要在服务器模板之前排序,以及 2) “您必须将帐户中的 Anchor Population Scope 值设置为 'Document'”。“=20 =]

项目 1 本身没有任何作用。第 2 项很有趣 - 我还没有完成。我将把我的解决方案部署到一个 DocuSign 帐户中,该帐户已经至少有一个 DocuSign 应用程序在生产中。 此设置是否会影响给定帐户的所有 DocuSign 应用程序?如果是这样,那就太不幸了。

更新两个

我不相信当该帐户有多个 docusign 应用程序时,我是否可以为整个帐户打开 'Anchor Population Scope' 标志。所以...

我不知道这是否是解决方案,但它似乎有效。我仍在使用复合模板,但我没有使用 serverTemplate,并且我在签名者中包含了静态定位的选项卡。信封看起来像这样:

{
    "compositeTemplates": [
        {
            "document": {
                "documentBase64": "...",
                "documentId": "1",
                "fileExtension": "pdf",
                "name": "file-one.pdf",
                "order": "1",
                "pages": "11"
            },
            "inlineTemplates": [
                {
                    "recipients": {
                        "signers": [
                            {
                                "deliveryMethod": "email",
                                "email": "docusign@example.com"
                                "roleName": "primary.account.holder",
                                "tabs": {
                                    "signHereTabs": [
                                        {
                                            "documentId": "1",
                                            "pageNumber": "11",
                                            "xPosition": "80",
                                            "yPosition": "534"
                                        }
                                    ]
                                }
                            }
                        ]
                    },
                    "sequence": "1"
                }
            ]
        },
        {
            "document": {
                "documentBase64": "...",
                "documentId": "2",
                "fileExtension": "pdf",
                "name": "page-two.pdf",
                "order": "2",
                "pages": "4"
            },
            "inlineTemplates": [
                {
                    "recipients": {
                        "signers": [
                            {
                                "deliveryMethod": "email",
                                "email": "docusign@example.com",
                                "tabs": {
                                    "signHereTabs": [
                                        {
                                            "documentId": "2",
                                            "pageNumber": "4",
                                            "xPosition": "80",
                                            "yPosition": "160"
                                        }
                                    ]
                                }
                            }
                        ]
                    },
                    "sequence": "1"
                }
            ]
        }
    ],
    "emailBlurb": "Please sign this document set (smoke-test)",
    "emailSubject": "Please sign this document set (smoke-test)",
    "status": "sent"
}

这使我能够用多种表格组成信封,其中许多表格具有相同的签名者,并且这些标签不会出现在信封中的第一个文档上。

我至少有 10-15 个表单,其中许多表单需要以无法方便地在单个模板中捕获的方式进行组合。

因此,我只需要为表单中的每个签名者关联一个选项卡集合,然后使用文档(在我的案例中生成)和一个包含每个签名者的选项卡的内联模板创建一个复合模板。

静态定位而不是锚点定位绕过了 'Anchor Position Scope' 标志的需要,代价是我需要自己跟踪选项卡数据而不是在模板中(这很不幸。)

上面'Update 2'中描述的信封为我解决了这个问题。将 'Anchor Population Scope' 设置为 document 而不是 envelope 可能也会有效。但是,在我的情况下,鉴于帐户中有应用程序,我不确定在帐户级别执行此操作是否会被批准。

基本上,复合模板非常灵活,我可以利用它来解决我原来的问题。