如何将值传递到echosign文档？

Question

我有一份协议需要签署。在客户为我们的服务提供他们的公司和付款信息后，打开到文档的链接。如何将公司名称或帐单地址等值从表单传递到文档？

现在，客户端单击"Go to Agreement“，它就会调出文档。问题在于，他们将不得不在echosign文档中重新键入他们刚刚在我们的表单上提交的信息。

Answer 1

您可以使用此A示例负载的mergeFieldInfo来实现相同的功能

{
  "documentCreationInfo": {
    "fileInfos": [
      {
        "libraryDocumentId": "xxxxxxxxxx"
      }
    ],
    "name": "xxxxxxxxxx xxxxxxxxxx",
    "message": "Please sign the agreement",
    "recipientSetInfos": [
      {
        "recipientSetRole": "SIGNER",
        "recipientSetMemberInfos": [
          {
            "email": "xxxx@xxxx.com"
          }
        ]
      }
    ],
    "signatureType": "ESIGN",
    "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED",
    "mergeFieldInfo": [
      {
        "fieldName": "firstName",
        "defaultValue": "xxxx"
      },
      {
        "fieldName": "lastName",
        "defaultValue": "xxxx"
      },
      {
        "fieldName": "email",
        "defaultValue": "xxxx@xxxx.com"
      },
      {
        "fieldName": "phone",
        "defaultValue": "xxxxxxxxxxxxxxxxx"
      },
      {
        "fieldName": "companyName",
        "defaultValue": "xxxx"
      },
      {
        "fieldName": "companyAddresss",
        "defaultValue": "xxxx xxxx"
      }
    ],
    "securityOptions": {
      "passwordProtection": "NONE",
      "kbaProtection": "NONE",
      "webIdentityProtection": "NONE",
      "protectOpen": false,
      "internalPassword": "",
      "externalPassword": "",
      "openPassword": ""
    }
  },
  "options": {
    "noChrome": false,
    "authoringRequested": false,
    "autoLoginUser": false
  }
}

Answer 2

您可以使用POST /agreements接口来实现此目的。这个接口调用的请求主体有一个可选的参数"formFields"，你可以在这里提供你想要在发送协议签名之前嵌入到你的文档中的表单字段，你也可以通过设置不同的属性来自定义这些字段，比如location，defaultValue，readOnly等等。

对于您的用例，您可以在POST调用中创建协议时传递此可选参数，指定您在前面的陡峭中从用户获取的字段的默认值以及您希望该字段在文档上放置的确切位置，如果您不希望用户更改这些字段，您甚至可以将其标记为只读。

为了让你更方便的PFB请求片段，你应该在你的POST调用中提供-

{ "formFields"：[{“formFields”："LEFT"，"borderStyle"："SOLID"，"fontColor"：""，"fontName"：""，"borderColor"：""，"displayLabel"：""，"radioCheckType"："CIRCLE"，"calculatedExpression"：""，"backgroundColor"："#0715cd"，"formatData"：""，"displayFormat"：""，"contentType"："DATA"，"validated"：false，"calculated"：false，"maxLength"：-1，"locations"：{ "height"：20，"width"：20，"pageNumber"：1，"left"：100，"top"：100 }，"minLength"：-1，"name"：“自定义字段2"，"inputType"："TEXT_FIELD"，"customDateFormat"：""，"specialFormula"：""，"required"：true，"defaultValue"：""，"minNumberValue"：0，"maxNumberValue"：0，"regularExpression"：""，"showOrHide"："SHOW"，"specialErrMsg"：""，"format"："NONE"，"fontSize"：-1，"masked"：false，"anyOrAll"："ANY"，"displayFormatType"："DEFAULT"，"conditions"：{ "value"：""，"whenFieldLocationIndex"：-1，"fieldName"：""，"whenFieldName"：""，"operator"："“}，"validationRule"："None"，"readOnly"：false，"borderWidth"：-1，"hidden"：false，"visibleOptions"：[]，"hiddenOptions"：[]，"tooltip"：“这是一个示例。”，"recipientIndex"：1 }] }