CIB jView sign technischer Leitfaden

2. Einführung

2.3. Konfiguration durch Properties

Allgemeine Properties

Mit den folgenden Properties können generelle Einstellungen für die Applikation vorgenommen werden.

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_ENABLED

sign.Enabled

Boolean

False

Diese Property legt fest, ob die Signatur-Komponente aktiviert oder deaktiviert ist.

TRUE: Im Menü erscheint der Menüeintrag „Signatur“ und in der Toolbarleiste erscheinen die Buttons „n Feld(er) zu signieren“ und „Signaturfeld aufziehen”.

FALSE: Der Menüeintrag „Signatur“ und die Toolbar-Buttons „n Feld(er) zu signieren“ und „Signaturfeld aufziehen” werden nicht angeboten.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_MENU_ENABLED

signmenu.Enabled

Boolean

True

Diese Property legt fest, ob das Signatur-Menü aktiviert oder deaktiviert ist.

TRUE: Das Signatur-Menü ist sichtbar.

FALSE: Das Signatur-Menü ist ausgeblendet.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_RESIGN_ENABLED

resign.Enabled

Boolean

True

Diese Property legt fest, ob das Nacherfassen einer Signatur möglich ist.

TRUE: Das Nacherfassen einer Signatur ist möglich.

FALSE: Das Nacherfassen einer Signatur ist nicht möglich.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_SHOW_SIGN

showsign.Enabled

Boolean

True

Diese Property legt fest, ob die Signatur-Vorschau nach dem Unterschreiben aktiviert ist.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_SHOW_PAGE_ON_PAD

showSignPageOnPad.Enabled

Boolean

False

Diese Property legt fest, ob die Seiten-Vorschau auf dem Signatur-Pad während des Unterschreibens aktiviert ist.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_SIGNATURECERTIFICATE

pad.SignatureCertificate

String

""

Diese Property legt das Signatur-Zertifikat für das Signatur-Pad fest.

Durch diese Property wird das Signatur-Zertifikat für das Signatur-Pad angegeben.

Default: Leerstring, es wird kein Signatur-Zertifikat für das Signatur-Pad gesetzt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_SIGNATUREPRIVATEPASSWORD

pad.SignaturePrivatePassword

String

""

Diese Property legt das Signatur-Passwort für das Signatur-Pad fest.

Durch diese Property wird das Signatur-Passwort für das Signatur-Pad angegeben.

Default: Leerstring, es wird kein Signatur-Passwort für das Signatur-Pad gesetzt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_HARDWARELICENCE

pad.HardwareLicence

String

""

Diese Property legt die Hardware-Lizenz für das Signatur-Pad fest.

Durch diese Property wird die Hardware-Lizenz für das Signatur-Pad angegeben.

Default: Leerstring, es wird keine Hardware-Lizenz für das Signatur-Pad gesetzt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_SIGNAPILICENCE

pad.SignApiLicence

String

""

Diese Property legt die API-Lizenz für das Signatur-Pad fest.

Durch diese Property wird die API-Lizenz für das Signatur-Pad angegeben.

Default: Leerstring, es wird keine API-Lizenz für das Signatur-Pad gesetzt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_PROVIDER

pad.Provider

String

""

Diese Property legt den Signatur-Pad Provider fest.

Durch diese Property wird der Name des Signatur-Pad Providers angegeben.

Default: Leerstring, es wird kein Signatur-Pad Provider gesetzt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_FREE_SIGN_ENABLED

freesign.Enabled

Boolean

True

Diese Property legt fest, ob das Aufziehen eines freien Signaturfelds erlaubt ist.

TRUE: In der Toolbarleiste erscheint ein Button "Signaturfeld aufziehen".

FALSE: Der Toolbar-Button "Signaturfeld aufziehen" wird nicht angeboten.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_REQUIRED_FIRST

signRequiredFirst.Enabled

Boolean

False

Legt fest, ob zuerst durch die notwendigen Signaturfelder navigiert wird.

TRUE: Zuerst wird durch die notwendigen Signaturfelder navigiert.

FALSE: Durch die Signaturfelder wird in der normalen Reihenfolge navigiert.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_DIALOG_POSITION

signDialogPosition

Integer

0

Legt die Position des Signaturdialogs relativ zu dem jeweils auszufüllenden Signaturfeld fest.

Mögliche Werte: 0 = oberhalb, 1 = unterhalb, 2 = links, 3 = rechts vom Signaturfeld.

Default: Der Signaturdialog wird oberhalb des Signaturfelds angezeigt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_START_ON_FLY

startSignOnFly.Enabled

Boolean

False

Legt fest, ob der Signaturvorgang direkt nach der Navigation zu einem Signaturfeld gestartet wird.

TRUE: Nachdem zu einem noch nicht unterschriebenen Feld navigiert wurde, wird sofort der Signaturvorgang gestartet.

FALSE: Der Benutzer muss nach dem Navigieren den Signaturvorgang selbst starten, indem er im Signaturdialog auf den Start-Button klickt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_OVERWRITE_OUTPUTFILE_ENABLED

overwriteOutputfile.Enabled

Boolean

False

Legt fest, dass beim Speichern der ersten Signatur kein Abfrage-Dialog erscheint, wenn das Outputfile bereits existiert.

TRUE: Beim Speichern der ersten Signatur erscheint ein Abfrage-Dialog, wenn das Outputfile bereits existiert.

FALSE (Default): Beim Speichern der ersten Signatur erscheint kein Abfrage-Dialog, wenn das Outputfile bereits existiert.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_SAVE_AND_NEXT

saveSignAndNext.Enabled

Boolean

True

Legt fest, ob direkt nach dem Speichern einer Signatur zum nächsten nicht ausgefüllten Signaturfeld navigiert wird.

TRUE: Direkt nach dem Speichern einer Signatur wird zum nächsten nicht ausgefüllten Signaturfeld navigiert.

FALSE: Nach dem Speichern einer Signatur wird nicht zum nächsten Signaturfeld navigiert.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_SAVE_AND_CLOSE

saveSignAndClose.Enabled

Boolean

False

Legt fest, ob das Dokument nach dem Speichern einer Signatur geschlossen wird.

TRUE: Das Dokument wird nach dem Speichern einer Signatur geschlossen.

FALSE: Das Dokument wird nur geschlossen, wenn das letzte Feld unterschrieben ist.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PRINT_ON_SAVE

printSignOnSave.Enabled

Boolean

False

Legt fest, ob das Dokument nach dem Speichern einer Signatur gedruckt wird.

TRUE: Das Dokument wird nach dem Speichern einer Signatur gedruckt.

FALSE: Das Dokument wird nur gedruckt, wenn das letzte Feld unterschrieben ist.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_PRINTER_NAME

printer.name.Enabled

String

„“

Legt den Druckernamen für das Drucken des Dokuments nach dem Speichern der letzten Signatur fest.

Default: Leerstring, d.h. für das Drucken des Dokuments ist kein Druckername gesetzt.

Falls ein Druckername gesetzt und die Property PROPERTY_SIGN_PRINT_ON_SAVE aktiviert ist, wird das Dokument auf den angegebenen Drucker gedruckt, wenn das letzte Feld unterschrieben ist.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_EXISTING_SIGNFIELD_WARNING

existingSignFieldWarning.Enabled

Boolean

True

Legt fest, ob eine Warnung erscheint, wenn kein Signaturfeld da ist.

TRUE: Eine Warnung erscheint, wenn kein Signaturfeld da ist.

FALSE: Wenn kein Signaturfeld da ist, erscheint keine Warnung.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_DIGSIG_GENERATED_FIELD

generatedDigSigField.Enabled

Boolean

False

Legt fest, ob ein selbst aufgezogenes Feld als DigSig unterschrieben werden kann.

TRUE: Erlaubt es, ein selbst aufgezogenes Feld als DigSig zu unterschreiben.

FALSE: Erlaubt es nicht, ein selbst aufgezogenes Feld als DigSig zu unterschreiben.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_REQUIRED_SIZE

signRequiredSize

Integer

3000

Legt die mindestens benötigte Grösse der Biodaten (in Byte) fest.

Wenn diese Mindestgröße beim Leisten der Signatur unterschritten wird, ist die Signatur nicht gültig und kann nicht gespeichert werden.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_REQUIRED_SIZE_ENABLED

signRequiredSize.Enabled

Boolean

True

Legt fest, ob die Property PROPERTY_SIGN_REQUIRED_SIZE ausgewertet wird.

TRUE: Wenn die in PROPERTY_SIGN_REQUIRED_SIZE gesetzte Mindestgröße beim Leisten der Signatur unterschritten wird, ist die Signatur nicht gültig und kann nicht gespeichert werden.

FALSE: Es gibt keine Mindestgröße beim Leisten der Signatur.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_READ_INFO

signReadInfo.Enabled

Boolean

True

Legt fest, ob die Signatur-Information (Name, Grund, Ort, Ausrichtung) aus der Vorbelegung durch den Signatur-Callback gelesen wird.

TRUE: Die Signatur-Information (Name, Grund, Ort, Ausrichtung) wird aus der Vorbelegung durch den Signatur-Callback gelesen.

FALSE: Die Signatur-Information (Name, Grund, Ort, Ausrichtung) wird nicht aus der Vorbelegung durch den Signatur-Callback gelesen.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_FORM_SIGNED_LOCK_ENABLED

formSignedLock.Enabled

Boolean

True

Diese Property legt fest, ob das Ausfüllen der Formularfelder gesperrt wird, wenn in einem Formular mindestens ein Signaturfeld unterschrieben ist.

TRUE: Wenn in einem Formular mindestens ein Signaturfeld unterschrieben ist, wird das Ausfüllen der Formularfelder gesperrt und es erscheint eine Hinweismeldung.

FALSE: Das Ausfüllen der Formularfelder wird nicht gesperrt, auch wenn in einem Formular mindestens ein Signaturfeld unterschrieben ist.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_NOT_FILLED_FORM_WARNING

signNotFilledFormWarning.Enabled

Boolean

True

Diese Property legt fest, ob eine Hinweismeldung erscheint, wenn in einem nicht ausgefüllten Formular ein Signaturfeld unterschrieben wird.

TRUE: Wenn in einem nicht ausgefüllten Formular ein Signaturfeld unterschrieben wird, erscheint eine Hinweismeldung, dass danach keine weiteren Formularfelder ausgefüllt werden können.

FALSE: Wenn in einem nicht ausgefüllten Formular ein Signaturfeld unterschrieben wird, erscheint keine Hinweismeldung, dass danach keine weiteren Formularfelder ausgefüllt werden können.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_SIGNATURE_ALIGNMENT

signature.alignment

String

2

Legt fest, mit welcher Ausrichtung die Signatur innerhalb des Signaturfeldes gespeichert wird.

1 = Die Signatur wird linksbündig gespeichert
2 = Die Signatur wird zentriert gespeichert (Default)
3 = Die Signatur wird rechtsbündig gespeichert

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_USEWINTAB

sign.UseWintab

String

0

Diese Property legt fest, ob zur Signaturerfassung kein Signatur-Eingabegerät (Signaturpad), also z.B. ein Windows-Tablet verwendet wird.

0 (Default): Zur Signaturerfassung wird ein Signatur-Eingabegerät (Signaturpad) verwendet.

1: Zur Signaturerfassung ist kein Signatur-Eingabegerät, sondern z.B. ein Windows-Tablet vorgesehen. Falls der PC kein Tablet ist und ein Signaturpad angeschlossen ist, wird dieses angesteuert und verwendet.

7: Zur Signaturerfassung wird in jedem Fall ein Windows-Tablet angesteuert und verwendet. Falls der PC kein Tablet ist, erscheint eine Fehlermeldung, auch wenn ein Signaturpad angeschlossen ist.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_SELECT_DIALOG

sign.SelectDialog

String

Standard

Diese Property legt die Art des angezeigten Signaturdialogs fest.

Standard (Default): Zur Signaturerfassung wird der Standard-Dialog verwendet.

Extended: Zur Signaturerfassung wird der erweiterte Dialog auf dem Signatur-Display verwendet.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_ACCEPT_BUTTONTEXT

sign.AcceptButtonText

String

OK

Diese Property legt Text des angezeigten Accept-Buttons fest.

<Text>: Im Signatur-Dialog wird als Accept-Button-Text der angegebene Text angezeigt.

(Default): Im Signatur-Dialog wird als Accept-Button-Text „OK“ angezeigt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_CANCEL_BUTTONTEXT

sign.CancelButtonText

String

Abbrechen

Diese Property legt Text des angezeigten Cancel-Buttons fest.

<Text>: Im Signatur-Dialog wird als Cancel-Button-Text der angegebene Text angezeigt.

(Default): Im Signatur-Dialog wird als Cancel-Button-Text „Abbrechen“ angezeigt.

 

 

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_REPEAT_BUTTONTEXT

sign.RepeatButtonText

String

Wiederholen

Diese Property legt Text des angezeigten Repeat-Buttons fest.

<Text>: Im Signatur-Dialog wird als Repeat-Button-Text der angegebene Text angezeigt.

(Default): Im Signatur-Dialog wird als Repeat-Button-Text „Wiederholen“ angezeigt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_WINDOWTEXT

sign.WindowText

String

Unterschrift

Diese Property legt den Text für den Titel des Dialogfensters fest, das zur Signaturerfassung angezeigt wird.

<Text>: Im Signatur-Dialog wird als Titel der angegebene Text angezeigt.

(Default): Falls die Property nicht gesetzt ist, wird als Titel „Unterschrift“ angezeigt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_TEXT

LcdText

String

„“

Diese Property legt den Text fest, der auf dem Signaturpad angezeigt wird.

<Text>: Auf dem Signaturpad wird der angegebene Text angezeigt.

(Default): Auf dem Signaturpad wird kein Text angezeigt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_TEXT_NAME_REASON

LcdTextNameReason

Boolean

False

Diese Property legt fest, ob Name und Grund jedes Signaturfelds als Text auf dem Signaturpad angezeigt wird.

TRUE: Name und Grund jedes Signaturfelds werden als Text auf dem Signaturpad angezeigt, falls diese nichtleer sind. Andernfalls wird der in der Property PROPERTY_SIGN_PAD_TEXT festgelegte Text angezeigt.

FALSE (Default): Auf dem Signaturpad wird der in der Property PROPERTY_SIGN_PAD_TEXT festgelegte Text angezeigt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_TEXTXPOS

LcdTextXPos

String

0

Diese Property legt die X-Position des auf dem Signaturpad angezeigten Texts fest.

<X>: Der auf dem Signaturpad angezeigte Text beginnt ab der angegebenen X-Position.

(Default): Der auf dem Signaturpad angezeigte Text beginnt ab der X-Position 0.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_TEXTYPOS

LcdTextYPos

String

0

Diese Property legt die Y-Position des auf dem Signaturpad angezeigten Texts fest.

<Y>: Der auf dem Signaturpad angezeigte Text beginnt ab der angegebenen Y-Position.

(Default): Der auf dem Signaturpad angezeigte Text beginnt ab der Y-Position 0.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_TEXTFONTNAME

LcdTextFontName

String

Arial

Diese Property legt die Schriftart des auf dem Signaturpad angezeigten Texts fest.

<FontName>: Der auf dem Signaturpad angezeigte Text wird in der Schriftart „FontName“ angezeigt.

 (Default): Die Standardschriftart ist Arial

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_TEXTFONTSIZE

LcdTextFontSize

String

12

Diese Property legt die Schriftgröße des auf dem Signaturpad angezeigten Texts fest.

<FontSize>: Der auf dem Signaturpad angezeigte Text wird in der Schriftgröße „FontSize“ angezeigt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_TEXTFONTSTYLE

LcdTextFontStyle

String

Normal

Diese Property legt den Schriftstil des auf dem Signaturpad angezeigten Texts fest.

<FontStyle>: Der auf dem Signaturpad angezeigte Text wird im Schriftstil „FontStyle“ angezeigt.

Mögliche Werte für Font-Style sind „Normal“, „Bold“, „Italic“, „Underline“. Kombinationen dieser Schriftstile sind nicht möglich.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_CONTROLMIRRORDISPLAY

sign.ControlMirrorDisplay

String

"1"

Diese Property legt fest, wie der Inhalt des LCD-Displays im Kontrollelement angezeigt wird.

Mögliche Werte:

"0" = Keine Anzeige im Kontrollelement

"1" = Die Signatur wird in Echtzeit im Kontrollelement angezeigt.

"2" = Die Signatur sowie Bitmaps und Text werden in Echtzeit im Kontrollelement angezeigt.

(Default): "1"

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_FILENAME

LcdFileName

String

„“

Diese Property legt den Dateinamen der auf dem Signaturpad angezeigten Bitmap fest.

<FileName>: Auf dem Signaturpad wird die in der Datei <FileName> enthaltene Bitmap angezeigt.

(Default): Auf dem Signaturpad wird keine Bitmap angezeigt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_PENWIDTH

LcdPenWidth

String

"12"

Diese Property legt die Linienbreite der auf dem Signaturpad erfassten Signatur fest.

<PenWidth>: Die auf dem Signaturpad erfasste Signatur hat die angegebene Linienbreite.

(Default): Die auf dem Signaturpad erfasste Signatur hat die Linienbreite 12.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_SENSORSIGNRECT

sign.SensorSignRect

String

"0;0;0;0"

Diese Property legt das Rechteck zur Signaturerfassung auf dem Signaturpad fest.

Werte: "<left>;<top>;<right>;<bottom>"

(Default): "0;0;0;0".

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_PAD_STANDBYNAME

LcdStandbyName

String

""

Diese Property setzt den Dateinamen der auf dem Signaturpad permanent angezeigten Bitmap.

(Default): Leerstring, d.h. es wird keine neue Bitmap gesetzt.

 

Property-Bezeichnung

Property-Text

Typ

Default

PROPERTY_SIGN_DIRECT_FROM_NATIVE_DIALOG

signdirect.Enabled

Boolean

false

Diese Property setzt ob die Signatur direkt nach der Bestätigung durch den nativen Dialog im Signaturfeld ohne weitere Bestätigung erfasst werden soll.

(Default): False, d.h. nach der Signaturefassung im nativen Dialog muss diese wieder im Signaturefeld bestätigt werden.