如何通过C#代码程序化选择DocuSign模板中的单选按钮

问题根源 #

你当前的代码是完全重新创建了一个RadioGroup并添加所有单选选项，这会覆盖模板中已配置好的单选组控件。DocuSign API在处理模板字段时，如果完全重新定义组内的所有选项，会替换掉模板中原有的对应控件。

正确解决方案 #

只需要定位到目标单选组，然后仅添加你需要选中的那个单选按钮即可，不需要重复定义组内的其他选项。模板中已存在的单选按钮会被保留，仅更新选中状态。

修改后的代码示例 #

// 定位到模板中的目标单选组，只需指定GroupName和DocumentId
RadioGroup radioGroup = new RadioGroup
{
    GroupName = templateField.DocuSignFieldName,
    DocumentId = "1",
    Radios = new List<Radio>()
};

// 只添加需要选中的那个单选按钮，不需要添加未选中的选项
radioGroup.Radios.Add(new Radio
{
    PageNumber = "3", // 必须与模板中对应单选按钮的页码一致
    Value = "Radio 1", // 必须与模板中对应单选按钮的Value值匹配
    Selected = "true",
    TabId = templateField.DocuSignFieldName // 可选，若模板中有TabId需匹配
});

radioTabs.Add(radioGroup);

关键注意事项 #

• 确保GroupName完全匹配模板中单选组的名称，这是定位到模板原有组的核心标识。
• Value、PageNumber必须与模板中你要选中的那个单选按钮的属性完全一致，否则无法正确匹配并选中。
• 不需要添加未选中的选项，DocuSign会自动保留模板中其他单选按钮的状态，仅将你指定的选项设为选中。

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