如何通过API/SDK指定文本框在PDF上签名？

Question

我使用的是SDK中的eSign模型。我实例化了一个新的docusign.esign.model.SignHere对象。我需要以某种方式将此处签名选项卡与PDF上的文本框关联吗？我尝试单独设置每个属性（如下所示），但没有得到预期的结果。同样，我希望将docusign.esign.model.Signhere选项卡与我的PDF中的预定义文本框关联起来。

var SignHereTab = new DocuSign.eSign.Model.SignHere();
SignHereTab.TabId = "<signature>";
SignHereTab.Name = "<signature>";
SignHereTab.AnchorCaseSensitive = "<signature>";
SignHereTab.CustomTabId = "<signature>";

或者，我是不是搞错了？如果我不能用文本框这样做，我可以用文本字段这样做吗？如果使用字段更好，我应该使用什么代码来将sign here选项卡与字段相关联？同样，我宁愿不使用X/Y或模板。

Answer 1

我是否正确地理解这是你想要完成的事情？

• 使用API创建一个信封，并将PDF指定为文档
• 根据字符串 在PDF中的显示位置，在文档中自动放置SignHere选项卡

如果是这种情况，那么您需要使用DocuSign所称的锚文本--锚文本是以普通文本形式存在于文档中的字符串（即，不是在文本框中，而是在页面上以普通文本形式存在）。本页的“获取要签名的文档”部分提供了如何使用锚文本的说明（甚至提供了包含锚文本的示例文档）。那一页的摘录：

Open Mutual_NDA.pdf in a PDF viewer. Search for the strings “signer1name”, “signer1sig”, and “signer1date”. You’ll notice that the search matches but that the text is not visible. These strings are regular text in the document. Their text color has been set to white, so they can’t be see in the document. But DocuSign can find them, and use them as anchor text to place the tabs (the signature, name, and date fields).

"recipients": {
    "signers": [
        {
            "roleName": "Signer1",
            "recipientId": "1",
            "name": "John Doe",
            "email": "[e-mail]",
            "tabs": {
                "signHereTabs": [
                    {
                        "anchorString": "<signature>",
                        "anchorIgnoreIfNotPresent": true,
                        "documentId": "1", 
                        "optional": false, 
                        "tabLabel": "Signature"
                    }
                ]
            }
        }
    ]
}

更新#1

如果签名出现在PDF上的文本框中很重要，您仍然可以使用锚文本来实现这一点。例如，只需将锚文本字符串（例如：）放在PDF中希望签名标记出现的文本框下方，指定anchorYOffset属性和anchorUnits属性告诉DocuSign希望签名选项卡相对于锚字符串位置出现的位置。在该示例中，API请求中签名选项卡的结构如下：

"signHereTabs": [
    {
        "anchorString": "<signature>",
        "anchorXOffset": "0", 
        "anchorYOffset": "-10",
        "anchorUnits": "pixels",
        "anchorIgnoreIfNotPresent": true,
        "documentId": "1", 
        "optional": false, 
        "tabLabel": "Signature"
    }
]

最后（供您参考），下面是与锚定字符串相关的选项卡属性的完整列表：