Copy link to clipboard
Copied
I am trying to add signature block as formfield at custom location in a PDF.
"formFields":[
{
"receipientIndex":"1",
"name":"test",
"inputType":"SIGNATURE",
"locations":[
{
"pageNumber":"1",
"top":"200",
"left":"100",
"width":"100",
"height":"20"
}
],
"conditions": [
{
"value": "Portland",
"whenFieldName": "Textfield4"
}
],
"fontSize":12,
"contentType":"SIGNATURE_BLOCK",
"showOrHide":"SHOW"
}
],
But irrespective of the location specified here, the signature block is rendered at a fixed place (somewhere in the middle). Also, how can we use the condition field properly?
Here is an example conditional signature form field that I have used successfully:
{
"name": "Conditional Signature",
"inputType": "SIGNATURE",
"contentType": "SIGNATURE",
"fontSize": "11",
"required": "true",
"readOnly": "false",
"defaultValue": "",
"conditions": [{
"operator": "EQUALS",
"value": "Texas",
"whenFieldName": "State",
"whenFieldLocationIndex": "0"
}],
"showOrHide": "SHOW",
"anyOrAll": "ANY",
"recipientIndex": "1",
"locations": [{
"pageNumber": "1",
"top" :"4
Copy link to clipboard
Copied
Here is an example conditional signature form field that I have used successfully:
{
"name": "Conditional Signature",
"inputType": "SIGNATURE",
"contentType": "SIGNATURE",
"fontSize": "11",
"required": "true",
"readOnly": "false",
"defaultValue": "",
"conditions": [{
"operator": "EQUALS",
"value": "Texas",
"whenFieldName": "State",
"whenFieldLocationIndex": "0"
}],
"showOrHide": "SHOW",
"anyOrAll": "ANY",
"recipientIndex": "1",
"locations": [{
"pageNumber": "1",
"top" :"450",
"left": "35",
"width": "210",
"height": "25"
}]
}
The signature block that is showing at the fixed location may be one that is added automatically by Adobe Sign. If any of your configuration/JSON is incorrect, your custom field will not display and the default one will display instead. This also depends on whether the recipient is a SIGNER, APPROVER, etc.
For the conditions to work, you need to include operator, value, whenFieldName, whenFieldLocationIndex, showOrHide, and anyOrAll. Some of these may not technically be required, but I had trouble getting the conditional field to work without them.
Copy link to clipboard
Copied
Thank you very much for the reply. Can you kindly let me know how was the whenFieldName inserted in the PDF? Can you kindly send me a sample PDF with such a field in it so that I can understand how to plant such a field in the PDF?
Copy link to clipboard
Copied
The location & conditions worked for us. Thanks a ton for sharing the sample request body. The API documentation that we have been referring is REST API — Document e-signature Software — Adobe Sign
But this documentation says that FormFieldCondition object looks like this:
value (string, optional😞 Value to compare the value of the whenField with, to evaluate the condition,
whenFieldLocationIndex (int, optional😞 Index of the location of the whenField whose value is the basis of the condition,
whenFieldName (string, optional😞 Name of the field whose value is the basis of condition
}
This doesn't have 'operator' field in it. Can you kindly let me know the API documentation you referred as we need the other possible values for 'operator' field ?
Copy link to clipboard
Copied
Glad that it helped!
The documentation you linked to is the version that I typically use as well. Unfortunately, I can't find the documentation where I originally found the 'operator' field - and in every case where I've used it, it has always been set to 'EQUALS'. It may be worth trying again without that field to see if it is still necessary.
Adobe Sign Text Tag Guide also lists some operators for use in text tags, but I'm not sure if those carry over to the API or not.