This topic contains the following information:

The E-Sign tab contains components that allow you to electronically sign a document.  

The E-Sign tab displays the Manage E-Signatures, Create Freehand Signature, Create Text Signature, Place E-Signature, and Place Date icons:

Creating Signatures

You can create the following E-Signatures:

• Freehand - draw your signature with your mouse
• Text - type your signature in a text box
• Date - select the date icon to apply the current date to your document

The following example shows the E-Signatures displayed in the Viewer:

The following section covers how to create freehand and text signatures.

To create a Freehand signature:

1. Click on the Create Freehand Signature icon. A dialog box displays:

2. Using your mouse, start to draw your signature in the box:

3. Select the Category: Signature, Initials or Title and then click Save.

To create a Text signature:

1. Click on the Create Text Signature icon. A dialog box displays:

2. In the Type Your Signature box, enter your signature. Choose one of the pre-filled signatures with the font you prefer:

3. Select the Category: Signature, Initials or Title and then click Save. 

To download a signature for your own record:

1. Click on the Manage E-Signatures icon. A dialog box displays:

2. Click on the Download Signature button.
3. A signature.json file is downloaded to your computer. Click Done.

Adding a Signature to a Document

To add a signature to a document:

1. Click on the Manage E-Signatures icon. A dialog box displays:

2. Click on Use Signature. A floating toolbar displays in the Viewer:

3. Click anywhere on the document where you want to place your signature. You can resize the signature using the yellow guide markers:

If you have more than one signature on the document, click on the signature and the yellow guide markers appear so you can see which signature is active.

4. If you want to change the color, size, layer order of the signature or add a comment, you can select the attributes from the icons in the floating toolbar:

When in Horizontal Layout Mode, comments are not supported in the Viewer.

If you want to delete the signature, click on the Trash can icon.

5. To save the signature, click the Save icon. The Save As field displays on the left-hand side of the Viewer:

6. Enter a name for the signature and click Save. 

Creating Signature Categories

The signature categories are a configuration option for the jQuery plugin. In the jQuery.fn namespace, there is a property called signatureCategories. The default samples have this set to "Signature,Initials,Title", but if you want to change it or add your own types, you can edit the initialization parameter. When this parameter is set, there will be a dropdown to select the category (when creating a new Freehand or Text signature). This dropdown will not be present if the signatureCategories parameter is not set. 

How Signatures are Saved

Signatures are persisted in the browser’s Local Storage so an end user can use the same signatures to sign across multiple documents and multiple sessions within the same browser. All signatures are stored in a JSON format under the storage key "pccvSignatures".

This storage method is a convenient way for end users to reuse previously created signatures, and is protected at the website domain level by the browser. However, this method may not be suitable for all business needs. The saving process is done inside viewer.js, in the E-Signature module, and can be overloaded, modified, or removed to match your business needs and criteria.

The Viewer expects signatures to be available in a collection object at PCCViewer.Signatures. Managing this collection is implemented as a module in the viewer.js file. See Modifying viewer.js for more information.

End users are also able to save their individual signatures for their own record using the "Download Signature" button under the Manage E-Signatures menu. This will download a plain-text JSON file of the selected signature.