DocuSign API自动将PDF字段转换为SecureFields

Question

使用DocuSign API创建新模板时，是否可以像使用Web控制台一样自动将PDF字段转换为DocuSign SecureFields？

发布到：

https://demo.docusign.net/restapi/v2/accounts/{account_id}/templates

要求正文：

{
        "emailsubject":"Please sign this",
        "templateId":"",
        "recipients":{
            "signers":[{
                "routingOrder":1,
                "roleName":"RoleOne",
                "recipientId":"1"
            }]
        },
        "envelopeTemplateDefinition":{
            "name":"test",
            "templateId":""
        },
        "documents":[{
            "documentId":"1",
            "name":"Agreement8_7_2012",
            "transformPdfFields":"true"
        }]
      }

我得到了成功的响应，并且仅在没有任何DocuSign SecureField的情况下创建了模板。

Answer 1

首先，尝试将收件人的defaultRecipient属性设置为true ：

"recipients":{
    "signers":[{
        "routingOrder":1,
        "roleName":"RoleOne",
        "recipientId":"1",
        "defaultRecipient":"true"
    }]
}

这将告诉DocuSign所有转换为DocuSign字段的PDF字段都应属于该收件人。

如果该更改不能解决您的问题，那么我可能怀疑，正是PDF字段的属性阻碍了转换的成功。 要进行故障排除，建议您执行以下操作：

• 验证PDF中的字段是否属于DocuSign将转换的字段类型（即CheckBox，DateTime，ListBox，Numeric，Radio，Text，Signature和Password）。

• 检查PDF中的字段属性。 好像DocuSign可能不会转换设置了某些保护属性的PDF字段（例如，Visible = false-或对于签名字段，Read-Only = true）。 也许开始在单个字段上尝试各种属性设置，以查看在PDF中更改字段属性是否使DocuSign能够转换该字段。

DocuSign REST API指南（ http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf ）的“转换PDF字段”部分[从第105页开始]包含有关字段转换过程的信息。