关于W9表单SSN/FEIN字段二选一必填逻辑的技术咨询

针对你提到的W9表单二选一必填的需求，不需要用嵌套标签组（嵌套组更多是UI层面的分组，校验逻辑得靠其他功能），这里有两种可靠的实现方式，结合DocuSign C# SDK就能搞定：

方案1：条件必填字段（推荐） #

这是最直接的方式，通过给每个字段设置条件必填规则，实现「如果另一组全空，则当前组必填」的逻辑。

具体逻辑： #

• 给SSN的3个输入框分别设置条件：当FEIN的2个输入框全部为空时，该SSN字段必填
• 给FEIN的2个输入框分别设置条件：当SSN的3个输入框全部为空时，该FEIN字段必填

这样签署人要么填完SSN的所有块，要么填完FEIN的所有块，不能都不填。

C# SDK代码示例： #

// 初始化签署者
var signer = new Signer
{
    Email = "signer@example.com",
    Name = "John Doe",
    ClientUserId = "123", // 如果是嵌入式签署
    RecipientId = "1"
};

// 创建SSN的三个输入字段
var ssnFields = new List<Text>();
foreach (var part in new[] { "ssn_part1", "ssn_part2", "ssn_part3" })
{
    ssnFields.Add(new Text
    {
        TabLabel = part,
        Width = 40,
        Height = 20,
        XPosition = part switch
        {
            "ssn_part1" => "100",
            "ssn_part2" => "150",
            "ssn_part3" => "200",
            _ => "100"
        },
        YPosition = "100",
        Required = false, // 默认非必填，由条件控制
        ConditionalRequired = new ConditionalRequired
        {
            Condition = "All", // 所有目标字段都满足条件
            TargetTabLabels = new List<string> { "fein_part1", "fein_part2" },
            Operator = "IsBlank" // 目标字段为空时，当前字段必填
        }
    });
}

// 创建FEIN的两个输入字段
var feinFields = new List<Text>();
foreach (var part in new[] { "fein_part1", "fein_part2" })
{
    feinFields.Add(new Text
    {
        TabLabel = part,
        Width = 60,
        Height = 20,
        XPosition = part switch
        {
            "fein_part1" => "100",
            "fein_part2" => "170",
            _ => "100"
        },
        YPosition = "150",
        Required = false,
        ConditionalRequired = new ConditionalRequired
        {
            Condition = "All",
            TargetTabLabels = new List<string> { "ssn_part1", "ssn_part2", "ssn_part3" },
            Operator = "IsBlank"
        }
    });
}

// 将字段添加到签署者的标签集合
signer.Tabs = new Tabs
{
    TextTabs = ssnFields.Concat(feinFields).ToList()
};

// 构建信封并发送（省略其他信封基础设置）
var envelopeDefinition = new EnvelopeDefinition
{
    Status = "sent",
    Recipients = new Recipients { Signers = new List<Signer> { signer } },
    // 添加文档等其他设置...
};

// 用SDK发送信封
var envelopesApi = new EnvelopesApi();
var envelopeSummary = envelopesApi.CreateEnvelope(accountId, envelopeDefinition);

方案2：信封级自定义校验（增强严格性） #

如果需要更严格的控制（比如禁止同时填写SSN和FEIN），可以在方案1的基础上，添加信封级校验规则，确保签署人只能选择其中一组填写。

C# SDK代码示例（添加到信封定义中）： #

envelopeDefinition.EnvelopeValidationRules = new List<EnvelopeValidationRule>
{
    new EnvelopeValidationRule
    {
        ValidationType = "Custom",
        ValidationMessage = "Please complete either the SSN fields OR the FEIN fields (not both).",
        // 表达式逻辑：要么SSN全填且FEIN全空，要么FEIN全填且SSN全空
        ValidationExpression = "(ssn_part1 != '' && ssn_part2 != '' && ssn_part3 != '' && fein_part1 == '' && fein_part2 == '') || (fein_part1 != '' && fein_part2 != '' && ssn_part1 == '' && ssn_part2 == '' && ssn_part3 == '')"
    }
};

为什么不推荐嵌套标签组？ #

嵌套标签组（nested tab groups）主要用于UI层面的字段分组展示（比如把SSN的3个块放在一个折叠组里），但它本身不提供「二选一必填」的校验逻辑，所以还是得结合条件必填或信封校验才能实现需求，没必要多此一举。

这样就能完美实现你要的逻辑，不用让CSR预填，签署人自己选择填写哪一组即可。

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