使用表单域嵌入签名PDF文档

时间:2015-11-10 23:06:18

标签: docusignapi

我目前处理的方案如下:

我们有一个应用程序可以预填充大部分PDF文档的表单字段和用户数据(想想姓名,地址等)。

此外,还有一些表单字段已根据在https://www.docusign.com/p/RESTAPIGuide/RESTAPIGuide.htm#REST%20API%20References/Document%20Parameters.htm#Transfor

中指定的详细信息进行了命名

例如,其中一个表单字段可能被命名为" first_name"并且填充了" John"的值,而另一个字段为空并命名为" eSignSignHere" (用于DocuSign签名)。

创建信封时,JSON有效负载看起来像下面的内容,通过HTTP POST提交给[baseUrl]/envelopes作为多部分请求,包括PDF。

{
  "emailSubject": "Test PDF Field Transform",
  "documents": [
    {
      "documentId": 1,
      "name": "fillable-form.pdf",
      "transformPdfFields": "true"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "email@email.com",
        "name": "John Smith",
        "recipientId": "1234",
        "clientUserId": "1234",
        "defaultRecipient": "true"
      }
    ]
  },
  "status": "sent"
}

正如所料,作为回应,我收到了一个信封ID& URI。

然而,当通过ID获取该信封时(使用[baseUrl]/envelopes/[envelopeId]/views/recipient),我看到自由格式签名视图,没有显示任何字段,而是字段工具箱,允许用户删除字段&他们喜欢的签名。

最终,我喜欢与通过网络控制台上传文档,选择"分配字段"时出现的行为相同的行为。

是否可以这样做,或者是将文档上传到自由格式标志的唯一选择?如果是后者,在此上下文中transformPdfFields属性的目的是什么?

1 个答案:

答案 0 :(得分:1)

经过更多搜索,我偶然发现了Docusign Transform Pdf Fields For single recipient?

稍微改变原始JSON有效负载,得出我之后的结果。 随后在带有PDF文档的多部分请求中提交的调整后的JSON现在是:

{
  "emailSubject": "Test PDF Field Transform",
  "compositeTemplates": [
    {
      "inlineTemplates": [
        {
          "sequence": 1,
          "recipients": {
            "signers": [
              {
                "email": "email@email.com",
                "name": "John Smith",
                "recipientId": "1234",
                "clientUserId": "1234",
                "defaultRecipient": "true"
              }
            ]
          }
        }
      ],
      "document": {
        "documentId": 1,
        "name": "fillable-form.pdf",
        "transformPdfFields": "true"
      }
    }
  ],
  "status": "sent"
}

为了显示转换后的PDF字段,而不是自由格式模式 - 这可以正常工作。