Docusign API：pageNumber 标签是必需的吗

Question

我一直在查看 Docusign API 网页，想知道任何给定“选项卡”子项（例如，signHereTabs、initialHereTabs、textTabs 等）的“pageNumber”标签是否是强制性的？

如果我有以下信息与 Docusign API 一起使用，是否会在整个多页文档中搜索“anchorString”值“[POS_Xn]”，或者我是否必须指定该值存在于哪个页面（在我的情况下为页面） 4 of 7) 通过在“signHereTabs”声明中添加“pageNumber”标签？

需要明确的是，值“[POS_Xn]”（“anchorString”的）仅在要签名的文档中出现一次。

{
    "emailSubject": "Please sign attached doc",
    "emailBlurb": "Info to be signed",
    "documents": [
        {
            "documentId": "1",
            "documentBase64": "Base64 string",
            "name": "Testfile1.pdf"
        }
    ],
    "recipients": {
        "signers": [
            {
                "email": "[email protected]",
                "name": "John Doe",
                "recipientId": "1",
                "routingOrder": "1",
                "tabs": {
                    "signHereTabs": [{
                        "anchorString": "[POS_Xn]",
                        "documentId": "1"
                    }]
                }
             }
        ]
    },
    "status": "sent"
}

Answer 1

仅当您使用 xPosition 和 yPosition 属性放置选项卡时才需要 pageNumber 属性。如果您使用锚字符串来放置选项卡，则无需包含 pageNumber 属性，因为选项卡将放置在文档中出现锚字符串的每个位置，并且将在文档的每个页面中搜索锚字符串。