DocuSign模板NumberTabs不显示问题及类型识别咨询

问题背景 #

使用DocuSign模板通过C# API对接时，TextTabs、CheckboxTabs字段值可正常传入显示，但NumberTabs字段值仅在发送前可见，打开信封后消失。改用Numerical类型字段传值后问题解决，现需明确如何识别模板中的字段为Numerical类型。

原NumberTabs传值代码：

Number n = new Number
{
     TabLabel = kvp.Key,// 对应DocuSign字段名，例如amount
     Value = kvp.Value // 例如25.53
};

List<Number>? numTabs = [];
numTabs.Add(n);

tabs ??= new Tabs();
tabs.NumberTabs = numTabs ;

// 后续填充信封/签署人信息

识别Numerical类型字段的两种方法 #

1. 模板编辑器直接查看 #

• 登录DocuSign后台打开目标模板，定位到目标字段。
• 点击字段查看属性面板，若“类型”选项显示为数值（Numerical）（而非“数字（Number）”），则该字段属于Numerical类型，需使用NumericalTabs传值。
• 注：DocuSign中“Number”是基础数字输入字段，“Numerical”是支持货币、百分比等格式的数值字段，二者对应API中不同的Tab类型。

2. 通过API获取模板字段详情 #

调用DocuSign的模板Tabs查询接口，直接获取字段的类型标识：

// 示例：调用API获取模板签署人Tabs信息
var apiClient = new ApiClient(basePath);
apiClient.Configuration.DefaultHeader.Add("Authorization", "Bearer " + accessToken);

var envelopesApi = new EnvelopesApi(apiClient);
var tabs = envelopesApi.ListTabs(accountId, templateId, recipientId);

// 检查Numerical类型字段
foreach (var numericalTab in tabs.NumericalTabs)
{
    if (numericalTab.TabLabel == "目标字段标识")
    {
        Console.WriteLine($"字段 {numericalTab.TabLabel} 为Numerical类型");
    }
}

// 对比：检查Number类型字段
foreach (var numberTab in tabs.NumberTabs)
{
    if (numberTab.TabLabel == "目标字段标识")
    {
        Console.WriteLine($"字段 {numberTab.TabLabel} 为Number类型");
    }
}

修正后的NumericalTabs传值代码 #

Numerical n = new Numerical
{
     TabLabel = kvp.Key,
     Value = kvp.Value
};

List<Numerical>? numericalTabs = [];
numericalTabs.Add(n);

tabs ??= new Tabs();
tabs.NumericalTabs = numericalTabs ;

// 后续填充信封/签署人信息

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