You need to enable JavaScript to run this app. PHP DocuSign API 第二签署方接收时自定义标签换行消失问题
优惠活动
大模型
产品
解决方案
定价
更多

PHP DocuSign API 第二签署方接收时自定义标签换行消失问题

解决方案

核心修复步骤

  • 第一步:预处理地址换行符,统一转换为DocuSign可识别的Windows风格换行符\r\n,避免不同系统换行符不兼容被过滤。预处理代码如下:
// 支持替换前端传入的<br>标签、Linux换行符和当前系统默认换行符
$formattedAddress = str_replace(["\n", "<br>", "<br />", PHP_EOL], "\r\n", $args['address']);
  • 第二步:给Tab补充shared和auto_size属性:shared设为true保证所有签署人看到的标签内容完全一致,避免跨角色重渲染时过滤换行;auto_size设为true保证标签高度自动适配多行内容,不会因高度不足隐藏换行。
  • 第三步:给所有5个签署人都添加这个配置完全一致的Tab,保证所有角色都能加载到同一个同步的标签值,不要只给首个签署人添加。

修改后的完整代码示例:

$purchaserAddress = new \DocuSign\eSign\Model\Note([
    'anchor_string' => '/purchaser_address/', 'anchor_units' => 'pixels',
    'anchor_y_offset' => '-3', 'anchor_x_offset' => '-4',
    'document_id' => "1", 'page_number' => "1",
    'font' => "TimesNewRoman", 'font_size' => "size8", 'bold' => 'true', 'tab_label' => "Purchaser Address",
    'value' => $formattedAddress, // 替换为预处理后的地址
    'locked' => 'true', 'tab_id' => 'address',
    'shared' => 'true', // 新增:跨签署人共享标签内容
    'auto_size' => 'true' // 新增:自动适配多行内容高度
]);
$text_tabs[] = $purchaserAddress;

兜底方案

如果以上配置仍然无效,由于你的地址标签本身是锁定不可修改的,可以直接在上传文档前预先把地址写入原始文档(比如生成PDF时直接渲染带换行的地址),再将文档上传到DocuSign创建信封,该方案可以100%保证所有签署人看到的地址格式完全一致,不存在换行丢失问题。

内容的提问来源于stack exchange,提问作者Marco MGI

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 11:24:05