User guide v4.x

The Digital Signature Client allows electronic digital signatures on documents in OpenKM.

Server configuration

Choose the File / Configuration menu option to show the configuration popup.

The available configuration parameters are:

Property	Type	Description
Language	Select	User interface language.
User	String	User ID for accessing OpenKM. user1
Password	String	The user's password. pass1
Host	String	OpenKM URL. http://localhost:8080/openkm/
Use personal token	Bool	The authentication will be done with the access token.
Personal token	String	The personal access token. okmpat-Ky1t16O2Rwx4ttPmOK0R

To accept configuration parameter changes, click the Accept button.

Signature configuration

The available configuration parameters are:

Property

Type

Description

Show document preview

Bool

When enabled, it allows you to preview documents.

Show signature

Bool

When activated, it makes the signature visible on the document.

The following fields will be enabled:

Page

Select

This option determines which page will be signed: it can be the first, the last, or dynamically, which allows you to select the page and the place where the signature will be inserted in real time.

Expr. X

String

Expression to set the X position.

Expr. Y

String

Expression to set the Y position.

Width

String

Defines the width of the signature, for example:

200

Height

String

Defines the height of the signature, for example:

100

Add watermark to signature

Bool

When activated, it allows you to add an image as a watermark to your signature.

The following fields will be enabled:

Select an image

String

Select the image for the watermark.

Opacity

Float

The watermark opacity. The range of values allowed is from 0 to 1.

Scale

Float

The scale of the image. The allowed range of values is 0 to 1.

In Expr. X and Expr. Y input fields, you can put more than a simple number. Currently, the following macros are defined:

SIGN_WIDTH
SIGN_HEIGHT
PAGE_WIDTH
PAGE_HEIGHT
PAGE_CENTER
PAGE_MIDDLE

So, to center a signature on the page, you can use:

Expr. X	PAGE_CENTER - SIGN_WIDTH / 2
Expr. Y	PAGE_MIDDLE - SIGN_HEIGHT / 2

Sign and upload documents

Select some files or folders with files and drag them to the Digital Signature Client to sign documents.

A popup will be shown to choose the certificate used to sign documents. Choose a certificate and click the Accept button.

Finally, a navigator popup will be shown to select the documents' folder destination. Select a folder with write access (for your user) and click the Sign button.

When the Digital Signature Client detects an existing document with the same name in OpenKM, it prompts a popup to choose one of two options: update the file or skip it.