使用 docusign api 时，若多个复选框共享相同 tablabel（或未设置），系统会将其视为同一逻辑控件，导致点击任一复选框时全部联动选中；正确做法是为每个复选框显式指定唯一且互不重复的 tablabel。
使用 docusign api 时，若多个复选框共享相同 tablabel（或未设置），系统会将其视为同一逻辑控件，导致点击任一复选框时全部联动选中；正确做法是为每个复选框显式指定唯一且互不重复的 tablabel。
在 DocuSign 中，复选框（Checkbox）的独立行为并非仅由 AnchorString 决定，而是由 TabLabel 属性主导——它是 DocuSign 服务端识别和分组表单字段的核心标识符。即使 AnchorString 各不相同（如 /cb1/, /cb2/, … /cb21/），若所有复选框的 TabLabel 缺失或被设为相同值（例如默认空字符串或统一硬编码），DocuSign 会将它们归为同一“字段组”，从而触发全选/全清的联动行为。
✅ 正确实现方式：为每个复选框分配唯一 TabLabel，并确保其与 AnchorString 语义一致、可追溯：
List<Checkbox> checkBoxes = new List<Checkbox>();
for (int index = 1; index <= 21; index++)
{
var checkbox = new Checkbox
{
AnchorString = $"/cb{index}/",
AnchorUnits = "pixels",
// ✅ 关键修复：必须设置唯一 TabLabel
TabLabel = $"checkBox{index}", // 唯一标识，不可为空或重复
// ⚠️ 注意：TabGroupLabels 已弃用，不应再用于控制独立性
// TabGroupLabels = new List<string>() { $"checkBox{index}" }, // ← 删除此行或保留但不依赖它
Shared = "false"
};
checkBoxes.Add(checkbox);
}? 重要说明：
- TabLabel 是 DocuSign 字段绑定与数据回传的唯一键（例如在 envelope.GetDocumentData() 或回调事件中，返回的 tabLabel 字段即为此值）；
- TabGroupLabels 属于旧版分组机制，自 DocuSign eSignature REST API v2.1 起已不推荐用于复选框独立性控制，且实际生效优先级低于 TabLabel；
- Shared = "false" 表示该字段不被多个签署人共享，虽有助于权限隔离，但不能替代 TabLabel 的唯一性要求；
- HTML 模板中锚点 /cbX/ 仅用于定位，不影响字段逻辑关系；真正决定“是否为同一字段”的是 TabLabel。
? 验证建议：
部署后，可通过 DocuSign Web 控制台打开该模板 → 进入“编辑字段”模式 → 查看每个复选框的“标签（Label）”属性，确认其值为 checkBox1、checkBox2 … checkBox21，且无重复。
总结：解决复选框联动问题的本质，是遵循 DocuSign 字段建模规范——每个需独立交互的复选框，必须拥有全局唯一的 TabLabel。忽略此规则，即使锚点、样式、循环逻辑完全正确，仍会导致意外的批量选中行为。
