DocuSign REST API（PHP）-预填充自定义标签

Question

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

从我的项目中，我成功地通过PHP API与DocuSign建立了连接，并收到了Embedded Singing View URL，该URL打开了我的模板，用户可以在其中毫无问题地签署文档。

但是...我所有的自定义文本标签都是空的，签名者可以在其中键入内容。 我需要用来自数据库的签名者个人数据预先填写。 我在DocuSign控制台和代码以及roleName-> tagLabel关系中对自定义标签标签的拼写，大小写进行了三重检查。 我的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

您需要使用textTabs在你的JSON类型，而不是customFields它用于别的东西。 例如，如果将数据字段从UI拖到文档上并给它命名为address ，以预填充该字段，则需要引用它的tabLabel和value字段，如下所示：

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