如何在 DocuSign 模板中实现每个复选框独立勾选

使用 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 个复选框将完全解耦，用户点击任一选项仅影响其自身状态，符合预期交互逻辑。