DocuSign compositeTemplate中radioGroupTabs锁定问题求助

安全阿岳

2026-8-16

解决DocuSign inlineTemplates中radioGroupTabs锁定问题

问题重现

使用inlineTemplates将含表单域的PDF添加到DocuSign信封时，textTabs、signHereTabs等标签能正常解析，但radioGroupTabs发送后处于锁定状态，仅将第一个签署人设为defaultRecipient时才可填写。尝试过用tabLabel替代groupName、通配符、精确字段名等方法均无效。

可行解决方案

1. 给radioGroupTabs明确绑定签署人ID

radioGroupTabs必须指定recipientId关联到目标签署人，否则DocuSign无法识别该字段归属，导致锁定。这是最关键的修复点——之前的代码未指定该属性，只有defaultRecipient会自动绑定，所以出现仅该场景可用的情况。

2. 确保groupName与PDF表单组名精确匹配

radio组不支持通配符匹配，必须与PDF中radio按钮组的实际名称完全一致（注意大小写、特殊字符）。检查PDF表单属性里的组名，避免使用多余转义字符（比如模板字符串中直接写ESIG_ADVISORDOC_SIGNER1_*而非ESIG_ADVISORDOC_SIGNER1_\\*）。

修改后的代码示例

tabs: {
    textTabs: [
      {
        tabLabel: `ESIG_ADVISORDOC_SIGNER1_*`,
        recipientId: "1" // 可选，但建议加上确保绑定
      },
    ],
    radioGroupTabs: [
      {
        groupName: `ESIG_ADVISORDOC_SIGNER1_TCP_ADD_REM`,
        recipientId: "1" // 必须指定，关联到目标签署人
      }
    ]
}