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
相关产品推荐
相关产品推荐

