Docusign响应式签名下手机号输入字段未在签署过程中展示如何解决

解决方案 #

导致响应式视图下手机号码字段不显示的核心原因是文本类型Tab默认不会被自动识别为响应式字段，你可以通过以下调整修复问题：

1. 给手机号码的Text对象显式添加IsResponsive = true配置
   你需要修改CreatePhoneAnchor方法，在初始化phoneText时新增字段声明，修改后的代码如下：

private Text CreatePhoneAnchor(string documentId, string phoneAnchor)
{
    var phoneText = new Text
    {
        DocumentId = documentId,
        Name = AppConstants.AppConstants.PhoneAnchor.Name,
        AnchorString = phoneAnchor,
        MaxLength = AppConstants.AppConstants.PhoneAnchor.MaxLength,
        Width = AppConstants.AppConstants.PhoneAnchor.Width,
        Height = AppConstants.AppConstants.PhoneAnchor.Height,
        IsResponsive = true, // 新增该行，显式声明为响应式字段
        DisableAutoSize = AppConstants.AppConstants.PhoneAnchor.DisableAutoSize,
        TabLabel = AppConstants.AppConstants.PhoneAnchor.TabLabel,
        Tooltip = AppConstants.AppConstants.PhoneAnchor.Tooltip,
        ValidationPattern = AppConstants.AppConstants.PhoneAnchor.ValidationPattern,
        ValidationMessage = AppConstants.AppConstants.PhoneAnchor.ValidationMessage,
        FontColor = AppConstants.AppConstants.PhoneAnchor.FontColor,
        Required = AppConstants.AppConstants.PhoneAnchor.Required
    };
    return phoneText;
}

2. 补充锚点定位校验
   如果添加上述配置后字段仍未显示，检查你的docx模板中对应手机号码锚点的文本：

• 确保锚点文本和你传入的phoneAnchor值完全一致，没有多余空格、换行、特殊符号
• 锚点文本不要设置透明色、和背景同色等隐藏样式，响应式视图会跳过无法识别的隐藏锚点对应的字段

3. 确认API版本兼容
   确保你使用的DocuSign eSignature API版本为v2.1 2022年6月及之后的版本，旧版本API对非签名类响应式字段的支持存在已知缺陷。

修改后重新生成签署链接即可看到手机号码字段会在响应式视图中正常显示，签署过程中就会要求用户填写完成后才能进入下一步。

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