DocuSign REST API (PHP) - 预填充自定义标签

Question

我正在从事需要使用 DocuSign API (PHP) 的项目。这是我第一次使用 DocuSign，我在 DocuSign 控制台中使用 roleName = signer 成功制作了模板。我还制作了自定义文本标签：address、city、state 和 phone，并将它们拖动到模板中的所需位置。我想在那里放置项目数据库中的客户（签名者）信息。

从我的项目中，我通过 PHP API 成功地与 DocuSign 建立了连接，并收到了嵌入式歌唱视图 URL，它打开了我的模板，用户可以在其中毫无问题地签署文档。

但是...我所有的自定义文本标签都是空的，签名者可以输入它们。我需要用来自数据库的签名者个人数据预先填充它们。我在我的 DocuSign 控制台和我的代码中以及 roleName->tagLabel 关系中三次检查自定义标签标签拼写、upper/lower 大小写。我的 PHP 代码如下。

有人可以告诉我我做错了什么吗？

我浪费了两天时间。

$data = array(
"accountId" => $accountId,
"emailSubject" => $this->_emailSubject,
"templateId" => $templateId,
"templateRoles" => array(
               array(
                   "email" => $email,
                   "name" => $recipientName,
                   "clientUserId" => $clientUserId,
                   "roleName" => "signer",
                   "customFields" => array(
                                "textCustomFields" => array (
                                                      array (
                                                          "name" => "address",
                                                          "value" => "Address from DB",
                                                          "show" => "true",
                                                          ),
                                                      array (
                                                          "name" => "city",
                                                          "value" => "City from DB",
                                                          "show" => "true",
                                                          ),
                                                      array (
                                                          "name" => "state",
                                                          "value" => "State from DB",
                                                          "show" => "true",
                                                          ),
                                                      array (
                                                          "name" => "phone",
                                                          "value" => "Phone from DB",
                                                          "show" => "true",
                                                          ),

                                               ),
                                     ),
                ),
                  ),
"status" => "sent"
);

Answer 1

您需要在 JSON 中使用 textTabs 类型，而不是用于其他用途的 customFields。例如，如果您将数据字段从 UI 拖到文档上并为其命名 address，要预填充该字段，您需要引用它的 tabLabel 和值字段，例如这个：

"roleName" => "signer",
"tabs" => array(
    "textTabs" => array(
        array(
            "tabLabel"=> "address",
            "value" => "123 Main St."
        ) 
    )
)

DocuSign REST API (PHP) - 预填充自定义标签

DocuSign REST API (PHP) - pre-fill custom tags

php

docusignapi

custom-tag