Docusign模板中已存在的Pre-fill工具文本字段赋值失败问题咨询

• 标签匹配错误
  代码中指定的TabLabel为TextName，和实际模板中定义的PatientName字段标签不一致，必须保证TabLabel取值和模板中已有预填充字段的标签完全匹配，包括大小写、空格、特殊字符，否则系统会判定为新建字段而非修改已有字段。
• 缺少TabId参数
  模板中提前创建的每个字段都有唯一的TabId标识，仅靠TabLabel匹配可能因为标签重复、后台存储格式差异等问题导致匹配失效，建议在Text对象中补充TabId参数，取值为模板中对应PatientName字段的唯一ID。
• 未配置字段关联规则
  仅构造Tabs对象无法将赋值规则关联到已有模板字段：
  1. 如果是基于模板创建信封的场景，需要在EnvelopeDefinition的CompositeTemplates节点下的对应InlineTemplates中，将Tabs对象绑定到对应文档的属性中，同时设置applyTemplateTabs = true，保证模板原有字段被保留且会被传入的赋值覆盖。
  2. 如果是修改已有信封的字段值，调用更新接口时需要额外指定tabs_action = update参数，默认不会覆盖已有字段的已存值。
• 字段类型不匹配
  确认模板中的PatientName字段确实是预填充字段（Prefill Tab），如果是归属到特定收件人角色的普通签名字段、自定义字段，放在PrefillTabs节点下是无法命中匹配的，这类字段需要放到对应收件人的TextTabs节点下赋值。

Text includedOnTemplate = new Text
{
    TabLabel = "PatientName", // 替换为模板中实际的字段标签
    // TabId = "xxx", 可选，补充模板字段的唯一ID提高匹配准确率
    Value = "Patient Name"
};
PrefillTabs PFT = new PrefillTabs();
PFT.TextTabs = new List<Text>();
PFT.TextTabs.Add(includedOnTemplate);
Tabs templateTab = new Tabs
{
    PrefillTabs = PFT,
    ApplyTemplateTabs = true // 保留模板原有字段，仅覆盖匹配到的字段值
};

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