DocuSign REST API：仅在指定文档而非所有信封文档启用signHereTabs

当向DocuSign发送多份文档时，希望signHereTabs不会应用于所有文档。例如，若有main.pdf和annex.pdf，两者均包含锚点字符串(SignatorySignature_1)，不希望该标签应用于annex.pdf——这份附件可能已签署过，不想让它被二次签署。

目前想到两种解决方案，但都有局限：

• 将annex.pdf以模态窗口展示（更倾向于内联视图）
• 为每个文档使用唯一的anchorString（当前代码实现难度较大）

请问是否有办法为标签指定目标文档列表，或者禁用特定文档的所有标签？

示例EnvelopeDefinition #

{
  "autoNavigation": true,
  "emailSubject": "xxxx",
  "allowComments": false,
  "recipients": {
    "signers": [
      {
        "email": "xxx@xxx.xx",
        "name": "xx",
        "clientUserId": 1,
        "recipientId": 1,
        "routingOrder": 1
      }
    ]
  },
  "status": "sent",
  "documents": [
    {
      "name": "main.pdf",
      "documentId": 1,
      "fileExtension": "pdf"
    },
    {
      "name": "annex.pdf",
      "documentId": 2,
      "fileExtension": "pdf"
    }
  ]
}

示例signHereTabs #

{
  "signHereTabs": [
    {
      "anchorString": "(SignatorySignature_1)",
      "anchorYOffset": -15,
      "anchorXOffset": 0,
      "anchorUnits": "pixels",
      "anchorIgnoreIfNotPresent": true,
      "anchorMatchWholeWord": true
    }
  ]
}

方法1：为锚点标签指定目标文档ID #

直接在signHereTabs的配置项中添加documentId字段，明确指定该标签仅作用于特定文档。比如你只想让锚点应用于main.pdf（对应documentId: 1），修改后的标签配置如下：

{
  "signHereTabs": [
    {
      "anchorString": "(SignatorySignature_1)",
      "anchorYOffset": -15,
      "anchorXOffset": 0,
      "anchorUnits": "pixels",
      "anchorIgnoreIfNotPresent": true,
      "anchorMatchWholeWord": true,
      "documentId": "1" // 指定仅对documentId为1的文档生效
    }
  ]
}

这个方案无需修改现有锚点字符串，还能保持所有文档的内联视图，完全匹配你的需求。

方法2：标记附件为无需签署的文档 #

如果annex.pdf是已完成签署的附件，可以在文档配置中添加自定义字段标记，再结合逻辑过滤标签，但这种方式需要额外的代码处理，优先级低于方法1。

内容的提问来源于stack exchange，提问作者EricD