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 SecureFields。

Answer 1

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

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

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

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

• 验证PDF中的字段是否属于DocuSign将转换的字段类型(即：复选框、日期时间、列表框、数字、无线电、文本、签名和密码)。

• 检查PDF中的字段属性。似乎DocuSign可能无法转换设置了某些保护属性的PDF字段(例如，Visible=false，或者对于签名字段，ReadOnly=true)。也许可以开始在单个字段上尝试各种属性设置，看看在PDF中更改字段属性是否可以使DocuSign转换该字段。

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