我有一个需要签署的协议。在客户为我们的服务提供他们的公司和付款信息后,该文件的链接就会打开。如何将公司名称或帐单地址等值从表单传递到文档?
现在,客户单击“转到协议”并显示文档。问题在于,他们将不得不在 echosign 文档中再次重新键入他们刚刚在我们的表单中提交的信息。
我有一个需要签署的协议。在客户为我们的服务提供他们的公司和付款信息后,该文件的链接就会打开。如何将公司名称或帐单地址等值从表单传递到文档?
现在,客户单击“转到协议”并显示文档。问题在于,他们将不得不在 echosign 文档中再次重新键入他们刚刚在我们的表单中提交的信息。
为此,您可以使用POST /agreements API。此 API 调用的请求正文有一个名为“formFields”的可选参数,您可以在此处提供要在发送协议进行签名之前嵌入到文档中的表单字段,您还可以通过设置不同的属性来自定义这些字段像 location、defaultValue、readOnly 等等。
对于您的用例,您可以在 POST 调用中创建协议时传递此可选参数,指定您在前一个陡峭的用户那里获取的字段的默认值以及您希望将该字段放置在文档上的确切位置,如果您不希望用户更改这些字段,您甚至可以将它们标记为只读。
为了让您更方便 PFB 您应该在 POST 调用中提供的请求片段 -
{ “formFields”:[{ “alignment”:“LEFT”,“borderStyle”:“SOLID”,“fontColor”:“”,“fontName”:“”,“borderColor”:“”,“displayLabel”:“” ,“radioCheckType”:“CIRCLE”,“calculatedExpression”:“”,“backgroundColor”:“#0715cd”,“formatData”:“”,“displayFormat”:“”,“contentType”:“DATA”,“已验证” :假,“计算”:假,“最大长度”:-1,“位置”:{“高度”:20,“宽度”: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” “:”,“格式”:“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 }] }“fieldName”:“”,“whenFieldName”:“”,“operator”:“”},“validationRule”:“None”,“readOnly”:false,“borderWidth”:-1,“hidden”:false,“ visibleOptions": [], "hiddenOptions": [], "tooltip": "这是一个示例。", "recipientIndex": 1 }] }“fieldName”:“”,“whenFieldName”:“”,“operator”:“”},“validationRule”:“None”,“readOnly”:false,“borderWidth”:-1,“hidden”:false,“ visibleOptions": [], "hiddenOptions": [], "tooltip": "这是一个示例。", "recipientIndex": 1 }] }visibleOptions": [], "hiddenOptions": [], "tooltip": "这是一个示例。", "recipientIndex": 1 }] }visibleOptions": [], "hiddenOptions": [], "tooltip": "这是一个示例。", "recipientIndex": 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
}
}