Page tree
Skip to end of metadata
Go to start of metadata

PDF visual signatures are supported for both individual signature and bulk signature by receiving all the visual signature required parameters (five as explained later) from the web application that invokes Blobfish Signer. The existence of these parameters is entirely optional, i.e. if they are omitted, Blobfish Signer will generate invisible signatures.

Visual signature configuration is currently unsupported directly from the Blobfish Signer application. As previously indicated, the associated parameters have to be provided by the web application.

  • Update "vis_sig_y" related documentation as its semantics are about to change in the 2.x releases.

Visual signature configuration for individual signature

First, take a look at Individual signature integration.

Basically, you need to provide the following highlighted five additional parameters.

<a href="bsign:?from=<downloadURL>&to=<uploadURL>&vis_sig_x=<location_from_left_border>&vis_sig_y=<location_from_top_border>&vis_sig_width=<visual_signature_rectangle_width>&vis_sig_height=<visual_signature_rectangle_height>&vis_sig_text=<text_to_be_displayed_in_the_visual_signature>">Sign</a>

The text to be displayed in the visual signature (vis_sig_text) supports some placeholders that will be replaced at runtime as follows:

An example hyperlink would be:

<a href="bsign:?from=http%3A%2F%2Fexample.org%2Fsample-app%2FDownload.do%3Fid%3D1&to=http%3A%2F%2Fexample.org%2Fsample-app%2FUpload.do%3Fid%3D1&vis_sig_x=20&vis_sig_y=705&vis_sig_width=250&vis_sig_height=70&vis_sig_text=Signed%20by%3A%20%3CSIGNER%3E%0ADate%3A%20%3CDATE%3E">Sign</a>

Where vis_sig_text is the URL encoded (percent-encoded) representation for: 

Signed by: <SIGNER>
Date: <DATE>

Visual signature configuration for bulk signature

First, take a look at Bulk signature integration.

As in "Visual signature configuration for individual signature" there are five additional parameters which should appear in the following order:

<downloadURL1>,<uploadURL1>,<documentName1>,<vis_sig_x_1>,<vis_sig_y_1>,<vis_sig_width_1>,<vis_sig_height_1>,<vis_sig_text_1>

<downloadURL2>,<uploadURL2>,<documentName2>,<vis_sig_x_2>,<vis_sig_y_2>,<vis_sig_width_2>,<vis_sig_height_2>,<vis_sig_text_2>

...

And a sample CSV with two signing entries would be the following one:

signature_entries.csv
http://example.org/sample-app/Download.do?id=1,http://example.org/sample-app/Upload.do?id=1,sample_document_1.pdf,20,705,250,70,"Signed by: <SIGNER>
Date: <DATE>"
http://example.org/sample-app/Download.do?id=2,http://example.org/sample-app/Upload.do?id=2,sample_document_2.pdf,290,705,250,70,"Signed by: <SIGNER>
Date: <DATE>"

 

 

 

  • No labels
Write a comment…