Input-XML - 5.Device Options

Options related to the Signature Device

NameDescription
<DeviceKind> or <PADART>Restricts valid signature devices to naturaSignPad-Series only.
<BlindPadSearch/>

Suppresses device configuration Dialog, if pad was changed.

Normally when signature is started, eSignatureOffice checks, if previously configured device is still connected and if not - device configuration dialog is shown.

When <BlindPadSearch/> is included in XML, eSignatureOffice tries to find signature devices without showing configuration dialog.

<DisableHashAbort/>Disables the Abort Button while displaying the Hash.
<ZoomLCD> 

Is an optional tag, that defines zoom value on the colour Device, when document view is enabled at startup.

The text inside the tag is an integer value in range 0..2,

0 = Fit to Width

1 = Fit to LCD (complete Page)

2 = maximal possible Zoom on Device

 

The Short form of the tag <ZoomLCD/> defaults to the value 0 = Fit to Width.

<DeviceKeys>

Disables all signature devices, except devices with encryption key hash equal to one of the values listed inside this tag.

There may be one or more <Hash>...</Hash>tags inside <DeviceKeys>.

Each <Hash> must contain a hash value of device encryption key.

<ErrorMessage> Text is shown to the user, when he tries to use a device with a different encryption key.

<HashDialog> 

Overrides default text in signed hash confirmation dialog.

<Width> and <Height> specifies the size of the dialog window,

<Message> is the text shown to user. There must be %s placeholder for the real hash value in the message text.

<PdfNoBiodata> 

When included in input XML, turns on creation of additional document with the same set of signatures, but without real biometrical data.

It's possible to specify either a path to the document,

like <PdfNoBiodata>C:\TEMP\no-bd.pdf</PdfNoBiodata>

or provide empty <PdfNoBiodata/> tag.

If empty tag is provided, document without biometrical data will be stored directly inside XML in base-64 encoded way.

<FrameColor>Overrides default signature frame color. The value of the tag must have numerical (decimal or hexadecimal) format.
<FrameThickness>

Overrides default signature frame thickness.

<SignPos>

This is an optional tag to specify the signable area on the signature device display. You can define multiple instances of this tag for each signature to specify the signable area for different products.

To do this, you have to specify the pad type with the product and/or vendor IDs (for example: <SignPos vid="22c9" pid="0CE1"> for a StepOver GmbH Brilliance pad). An ID of "0000" or an ID not specified is considered to not be determined and so all possible values are accepted, for example to set values for all StepOver GmbH devices.  Please take a look at this table to find the product and vendor ID of your device as well as its display resolution for the following tags:

<X> and <Y> specify the coordinates of the upper left corner of your designated signable area in pixel. Generally, the 0/0 coordinate is in the upper left corner of the device display.

<Width> and <Height> specify the size of the signable area in pixel.

Only positive and whole numbers are usable.

Does NOT work in the SignInDocumentMode!

Example
    <Signatures>
      <Signature>
        <Placeholder>Unterschrift Depotinhaber 1</Placeholder>
        <Width>4</Width>
        <Height>3</Height>
        <DisplacementTLIndex>7</DisplacementTLIndex>
        <FeldPositionIndex>3</FeldPositionIndex>
        <Offset_X>0</Offset_X>
        <Offset_Y>-3</Offset_Y>
        <Signed>0</Signed>
		</SignPos>
			<SignPos device="duraSignBrilliance">
			<X>50</X>
			<Y>272</Y>
			<Width>629</Width>
			<Height>202</Height>
		</SignPos>
	</Signature>

 

<DeviceDetails/> Tag passed as input tag, is filled with device model name, serial number and firmware version on output.

Parameters of device used for last signature are stored.

See filling sample below.

Example
<DeviceDetails>
  <Model>StepOver naturaSign Pad Mobile</Model>
  <FirmwareVersion>4.3 E.1.1293</FirmwareVersion>
  <SerialNumber>123457001</SerialNumber>
</DeviceDetails>