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 |
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. |