使用 docusign api 动态添加多个复选框时，若未为每个复选框设置唯一 tablabel，系统会将其识别为同一逻辑控件，导致点击任一复选框时全部联动选中；正确做法是为每个 checkbox 实例显式指定唯一的 tablabel。
使用 docusign api 动态添加多个复选框时，若未为每个复选框设置唯一 tablabel，系统会将其识别为同一逻辑控件，导致点击任一复选框时全部联动选中；正确做法是为每个 checkbox 实例显式指定唯一的 tablabel。
在 DocuSign 的标签（Tab）机制中，AnchorString 仅用于定位控件在文档中的位置，而控件的逻辑身份由 TabLabel 决定。当多个 Checkbox 共享相同的 TabLabel（或完全未设置 TabLabel），DocuSign 会将它们视为同一组单选式复选框（即“互斥复选框”），从而触发全选/全清行为——这正是你遇到问题的根本原因。
✅ 正确实现方式：为每个复选框分配唯一且明确的 TabLabel。修改你的 C# 构建逻辑如下：
List<Checkbox> checkBoxes = new List<Checkbox>();
for (int index = 1; index <= 21; index++)
{
var clickCheckboxHere = new Checkbox
{
AnchorString = $"/cb{index}/",
AnchorUnits = "pixels",
// AnchorXOffset/AnchorYOffset 可留空（自动对齐）或按需设置偏移量
TabLabel = $"checkBox{index}", // ✅ 关键修复：必须设置唯一 TabLabel
TabGroupLabels = new List<string> { $"checkBox{index}" }, // （可选）如需分组操作可保留，但非必需
Shared = "false",
Required = "false", // 根据业务需要设置
Selected = "false" // 初始状态设为未选中
};
checkBoxes.Add(clickCheckboxHere);
}⚠️ 注意事项：
- TabLabel 是 DocuSign 后端识别控件唯一性的核心字段，不可为空、不可重复、不可仅依赖 AnchorString 替代；
- TabGroupLabels 用于定义标签组（如签名组、审批组），与单个控件的独立性无关，不影响勾选行为；
- 若模板中已存在同名 TabLabel（例如历史版本残留），建议清理模板或使用全新 TabLabel 命名空间（如 "template_cb_001"）避免冲突；
- 测试时建议使用 EnvelopeDefinition.Status = "created" 先创建草稿，通过 DocuSign Web 控制台预览表单行为，确认各复选框可独立交互后再发送。
? 补充建议：为提升可维护性，可将复选框配置抽象为数据驱动模型：
var checkboxConfigs = Enumerable.Range(1, 21)
.Select(i => new { Index = i, Label = $"agreement_term_{i}", Anchor = $"/cb{i}/" })
.ToList();
foreach (var cfg in checkboxConfigs)
{
checkBoxes.Add(new Checkbox
{
AnchorString = cfg.Anchor,
TabLabel = cfg.Label,
// ... 其他属性
});
}至此，21 个复选框将完全解耦，用户点击任一选项仅影响其自身状态，符合预期交互逻辑。
