如何通过DocuSign PHP SDK让所有签署者可见全部Fullname及Text标签？

要让所有签署者随时查看全部full_name和text标签，核心是把这类标签设置为共享标签，让DocuSign对所有签署者开放可见权限。具体修改分为两种场景：

1. 调整现有签署者标签的属性 #

如果你的full_name和text标签是绑定到单个签署者创建的，只需给这两类标签添加shared属性为true，同时可选设置recipient_id为all明确指定所有收件人可见：

$tabs = new Tabs([
    'full_name_tabs' => [
        new FullName([
            'anchor_string' => "****fullname-$key****",  
            'anchor_units' => "pixels",  
            'anchor_x_offset' => "-5",  
            'anchor_y_offset' => "0",
            'bold' => true,
            'shared' => true, // 关键：设置为共享标签
            'recipient_id' => 'all' // 可选：明确所有收件人可见
        ]),
    ],
    'text_tabs' => [
        new Text([
            'anchor_string' => "****fullname-$key****",
            'anchor_units' => "pixels",
            'anchor_x_offset' => "-5",
            'anchor_y_offset' => "13",
            'value' => $signer['role'],                        
            'bold' => true,
            'shared' => true, // 关键：设置为共享标签
            'recipient_id' => 'all' // 可选：明确所有收件人可见
        ]),
    ],
    'sign_here_tabs' => [
        new SignHere([
            'anchor_string' => "****signature-$key****",  
            'anchor_units' => "pixels",  
            'anchor_x_offset' => "5",  
            'anchor_y_offset' => "40",
            // 签署框保持专属，不设置shared
        ]),
    ],
]);

2. 将共享标签绑定到文档（更推荐） #

如果希望共享标签属于文档本身而非单个签署者，可在创建Document对象时直接添加这些标签，这样所有签署者打开文档时都会自动看到：

// 先创建共享标签集合
$sharedTabs = new Tabs([
    'full_name_tabs' => [
        new FullName([
            'anchor_string' => "****fullname-$key****",  
            'anchor_units' => "pixels",  
            'anchor_x_offset' => "-5",  
            'anchor_y_offset' => "0",
            'bold' => true
        ]),
        // 可添加其他签署者的fullname标签
    ],
    'text_tabs' => [
        new Text([
            'anchor_string' => "****fullname-$key****",
            'anchor_units' => "pixels",
            'anchor_x_offset' => "-5",
            'anchor_y_offset' => "13",
            'value' => $signer['role'],                        
            'bold' => true
        ]),
        // 可添加其他签署者的role文本标签
    ]
]);

// 创建文档时绑定共享标签
$document = new Document([
    'document_base64' => $yourBase64DocumentContent,
    'name' => '待签署文档',
    'document_id' => '1',
    'tabs' => $sharedTabs // 将共享标签绑定到文档
]);

// 后续创建签署者时，仅添加专属的sign_here标签即可
$signerTabs = new Tabs([
    'sign_here_tabs' => [
        new SignHere([
            'anchor_string' => "****signature-$key****",  
            'anchor_units' => "pixels",  
            'anchor_x_offset' => "5",  
            'anchor_y_offset' => "40"
        ])
    ]
]);

注意事项 #

• sign_here标签不要设置shared，确保每个签署者只能看到自己的签署框。
• 如果使用锚点字符串，要确保文档中对应的锚点位置唯一，避免标签错位。

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