7. Startparameter
- Michael Spreen
Übergabe von Parametern
Um eSignatureOffice aus einer anderen Anwendung heraus zu starten, müssen Sie die „SOSigOffice.exe" aufrufen. Dieser können Sie beim Aufruf verschiedene Parameter übergeben.
Wenn Sie nicht wissen, in welchem Verzeichnis eSignatureOffice liegt, finden Sie den Speicherort über folgenden Registry-Eintrag heraus:
HKEY_LOKAL_MACHINE\SOFTWARE\STEPOVER\ESIGNATUREOFFICE X.XX\PATH (under 64Bit: HKEY_LOKAL_MACHINE\SOFTWARE\Wow6432Node\STEPOVER\ESIGNATUREOFFICE X.XX\PATH )
Standardmäßig wird bei der Installation von eSignatureOffice der Pfad "C:\Program Files (x86)\StepOver\eSignatureOffice 5.0" vergeben.
Darstellung und Design
Parameter | Values | Info |
|---|---|---|
-left=<integer_value> | ganze Zahl | Falls Sie eSignatureOffice nicht im Vollbildmodus starten, definieren Sie hier die x-Koordinate, um eine gewünschte Position beim Ausführen festzulegen. Die linke obere Bildschirmecke wird dabei als Nullpunkt betrachtet. |
-top=<integer_value> | ganze Zahl | Falls Sie eSignatureOffice nicht im Vollbildmodus starten, definieren Sie hier die y-Koordinate, um eine gewünschte Position beim Ausführen festzulegen. Die linke obere Bildschirmecke wird dabei als Nullpunkt betrachtet. |
| -width=<integer_value> | ganze Zahl | Falls Sie eSignatureOffice nicht im Vollbildmodus starten, definieren Sie hier die Breite, um eine gewünschte Fenstergröße beim Ausführen festzulegen. |
-height=<integer_value> | ganze Zahl | Falls Sie eSignatureOffice nicht im Vollbildmodus starten, definieren Sie hier die Höhe, um eine gewünschte Fenstergröße beim Ausführen festzulegen. |
-gmN | Zum Wechseln der Oberflächen von eSignatureOffice. "-gm0" = traditional (eSignatureOffice 3.x) "-gm1" = traditional minimalistic (eSignatureOffice 3.x) "-gm2" = classic (eSignatureOffice 4.x) "-gm3" = classic reduced (eSignatureOffice 4.x) "-gm4" = New GUI (eSignatureOffice 5.x) | |
-hideframe | Ausblenden des Fensterrahmens. Dieser Parameter funktioniert nur mit der eSignatureOffice 3.x Oberfläche. | |
-hidestartwin | Beim Öffnen von eSignatureOffice - sei es manuell, durch die Übergabe mittels des PDF Converters oder durch Starten der Anwendung über den Parameter „eSOSigOffice.exe" aus einer anderen Anwendung heraus – erscheint für kurze Zeit ein Fenster, das dem Benutzer den Start von eSignatureOffice signalisiert. Durch den Befehl „-hidestartwin" können Sie das Erscheinen dieses Startfensters deaktivieren. | |
| -hidesignbtn | Die Schaltfläche "Signaturmodus" wird nicht angezeigt | |
| -hidesupportbtn | Der Support Button im Info Dialog bzw. im Menü ist deaktiviert | |
| -support | Support Fenster wird direkt nach dem Start geöffnet | |
deactivateXXXX -deactivateXXXX deactivate=XXXX -deactivate=XXXX | Diese Option hat nur Auswirkungen auf das „alte" Fensterdesign, d.h. wenn das „Neue Fensterdesign" deaktiviert wurde
| |
-zoom= | ganze Zahl | Mit diesem Parameter kann man den Dokumenten-Zoom beim Starten mit angeben. (Zahl = Prozent der Vergrößerung) |
| -zoomaftersign= | ganze Zahl | Definiert die Zoomstufe nach dem Unterschriftenmodus (inkl. Signaturabbruch) "10" ... "300" = Zoom in Prozent "fit" oder "f" oder "0" = Seitenansicht 'k' oder 'keep' oder kein Wert bedeutet das die Zoomstufe des Unterschriftenmodus erhalten bleibt |
| -zoomlcd= | ganze Zahl | Definiert die Zoomstufe der Dokumentenanzeige auf dem Farbpad 0 = Seitenanzeige 1 = Seitenbreite 2 = größte Zoomstufe |
| -minimize | eSignatureOffice startet minimiert | |
| -maximize | eSignatureOffice startet im Vollbild Modus | |
| -monitor=<MonitorIndex> | ganze Zahl | Definiert auf welchen Bildschirm das eSignatureOffice gestartet wird |
| -setfocus | Dieser Parameter sorgt dafür das eSignatureOffice sich im Focus befindet. Dies ist zum Beispiel nicht der Fall wenn der Unterschriftenprozess über den PDF Konverter gestartet wird. |
Verhalten bzw. zu Grundeinstellungen
Parameter | Values | Info |
|---|---|---|
| -lang=<Ing> | D,GB, ES, NL, PL, F | Mit diesem Befehl können Sie automatisch die Sprache von eSignatureOffice festlegen. Die entsprechenden Werte der jeweiligen Sprachen in <lng> sind <D>, <GB>, <ES>, <NL>, <PL> sowie <F>. |
| -SaveDoc | Der Parameter -SaveDoc wird z.B. vom StepOver PDF Converter an eSignatureOffice übergeben, was dann davon ausgeht, dass es sich bei der geöffneten PDF-Datei um eine temporäre Datei handelt und dementsprechend beim Beenden der Anwendung nachfragt, ob die Datei gespeichert werden soll, auch wenn sie nicht verändert wurde. Ein Klick auf den „Speichern"-Knopf führt in diesem Fall zum „Speichern unter..." Dialog. | |
| -sofcrenameto=<file_name> | Dieser Befehl ist dann relevant, wenn ein signiertes Dokument über eine Makroschaltfläche automatisch gespeichert werden soll. Dies kann entweder durch das Betätigen einer sichtbaren Makroschaltfläche passieren oder aber auch über eine unsichtbare Schaltfläche, die automatisch nach dem Unterschreiben durch ein Signatur-Set aktiviert wird. Mit Hilfe dieses Befehls können Sie nun den Dateiname ändern, unter welchem ein signiertes Dokument gespeichert werden soll. Der Parameter ändert dann den Dateiname des Originals bzw. gegebenenfalls den, der beim Konfigurieren der Makroschaltfläche unter „Dateiname nach dem Kopieren umbenennen in" angegeben worden ist. | |
| -stayontop | Soll eSignatureOffice während das Programm ausgeführt wird immer im Vordergrund bleiben, so können Sie dies über den Parameter „-stayontop" erreichen. Somit bleiben andere, sich öffnende Anwendungen stets im Hintergrund. eSignatureOffice kann dann nur noch durch Anklicken von „Minimieren" im Rahmen rechts oben minimiert werden. | |
*.scs (Configuration-Set-Datei) | Dateipfad oder URL | Eine StepOver Configuration-Set-Datei (*.scs) ist eine Datei, die alle Einstellungen von eSignatureOffice enthalten kann, wie z.B. Einstellungen für Makroschaltflächen, Benutzerrechte oder Sicherheit & Schlüsselverwaltung etc. – sehen Sie dazu auch das Kapitel "eSignatureOffice Administration" Exportieren der Einstellungen. Eine als Startparameter übergebene *.scs Datei wird, im Gegensatz zu dem Befehl [Optionen | Importieren], sofort ohne Nachfrage an den Anwender importiert. |
| -multi | Durch diesen Parameter ist das Starten von mehreren Instanzen von eSignatureOffice möglich. | |
| -nodrawdata | Sorgt dafür, dass keine Informationen über das Zeichnen der Unterschrift im PDF abgespeichert werden. Damit verkleinert sich die Dateigröße. | |
| -nobiodata | Sorgt dafür, dass keine biometrischen Daten zur Unterschrift im PDF-Dokument gespeichert werden. Innerhalb des Dokumentes wird lediglich das Bild der Signatur abgespeichert. Dadurch verringert sich auch die Dateigröße nach der Unterschrift ein wenig. Der Befehl "nobiodata" beinhaltet nodrawdata. | |
| -df= | ganze Zahl | Dieser Befehl ist ebenso dafür da, die Dateigröße zu reduzieren, dabei wird jeder "N"te Messpunkt der Signatur ignoriert. Bei der Angabe "-df=5" wird jeder fünfte Punkt beim Zeichnen der Signatur nicht mit verwendet. Bei der Angabe "-df=2" würde zum Beispiel nur die Hälfte aller Messpunkte berücksichtigt werden. |
| -page=<pagenumber> | ganze Zahl | Mit diesem Befehl kann man die Seite angeben, die beim übergebenen Dokument direkt angezeigt werden soll. |
| -printonly | Direkt nach dem Starten von eSignatureOffice öffnet sich der Drucken-Dialog. | |
| -dkf= | ganze Zahl | Mit diesem Befehl kann man den Pad-Typen festlegen, der benutzt werden darf. Zurzeit sind die beiden Angaben "-dkf=naturaSignPad" oder "-dkf=nsp" möglich, mit denen man die Benutzung auf das naturaSign Pad beschränken kann. |
| -nosealedmsg= | Dieser Befehl sorgt dafür, dass die Bestätigungsmeldung nach dem Versiegeln nicht mit angezeigt wird. Hinweis, die Versiegelungsmeldung erscheint bei der aktuellen Version nicht mehr. | |
| -mds | aktiviert den Button für die Manuelle Suche von Seriellen Geräten in der Administration (unter Signaturegeräte) | |
| -hidesss | SignatureSet Einstellungen im Menü und der Seitenleiste werden ausgeblendet | |
| -hidesssmenu | SignatureSet Einstellungen im Menü werden ausgeblendet | |
-hidesssfiles | SignatureSet Einstellungen in der Seitenleiste werden ausgeblendet | |
| -nocentersign | Unterschriftenpositionierung wird nicht mehr zentriert wenn man mit der Unterschrift beginnt | |
| -noscrollsign | Deaktivieren des Dokumenten scrollen während des Unterschreibens in eSignatureOffice | |
| -rotate | Rotiert alle Seiten des PDF Dokuments um 90° im Uhrzeigersinn. Bitte beachten sie, dass dieser Parameter ignoriert wird, wenn im Dokument bereits irgendwelche digitalen Signaturen enthalten sind! Andernfalls würden diese Signaturen ungültig aufgrund der veränderten PDF Struktur. | |
| -rotate=<Degree> | integer | Rotiert alle Seiten des PDF Dokuments im Uhrzeigersinn um <Degree> Grad, wobei dieser Wert entweder 90, 180 oder 270 betragen darf. "-rotate=90" liefert also das gleiche Ergebnis wie "-rotate". Bitte beachten sie, dass dieser Parameter ignoriert wird, wenn im Dokument bereits irgendwelche digitalen Signaturen enthalten sind! Andernfalls würden diese Signaturen ungültig aufgrund der veränderten PDF Struktur. |
-PadRotateStart=<orientation value> | ganze Zahl von 0 bis 5 | Rotiert die Ansicht auf dem angeschlossenen und voreingestellten Unterschriftenpad beim Programmstart in die entsprechende Richtung, die durch den Orientation value angegeben ist. Ohne Veränderung = 0 Landscape = 1 (dies ist die Standardorientierung) Landscape (für Linkshänder) = 2 Portrait (Hochkant-Modus) = 3 Portrait (für Linkshänder) = 4 Bitte beachten Sie, dass das nur für bereits konfigurierte Geräte funktioniert (also normalerweise nicht für den allerersten Start mit einem neu angeschlossenen Gerät)! |
-PadRotateEnd=<orientation value> | ganze Zahl von 0 bis 5 | Rotiert die Ansicht auf dem angeschlossenen und voreingestellten Unterschriftenpad beim Programmende in die entsprechende Richtung, die durch den Orientation value angegeben ist. Ohne Veränderung = 0 Landscape = 1 (dies ist die Standardorientierung) Landscape (für Linkshänder) = 2 Portrait (Hochkant-Modus) = 3 Portrait (für Linkshänder) = 4 Auf den Startwert setzen = 5 Bitte beachten Sie, dass das natürlich nur bei ordnungsgemäßem Schließen des Programmes funktioniert. |
Startparameter zur Workflow-Integration
Parameter | Values | Info |
|---|---|---|
*.fff (Form Field Filler Datei) | Dateipfad oder URL | Eine solche Datei enthält die Namen der Formfelder einer PDF-Datei, die ausgefüllt werden sollen, sowie deren Wert bzw. Text. eSignatureOffice füllt dann beim Start automatisch die Formfelder der PDF-Datei aus und zeigt die ausgefüllte PDF-Datei an. Die Angabe einer *.fff-Datei ist nur in Verbindung mit Angabe der entsprechenden PDF-Datei sinnvoll. Diese *.fff-Datei ist wie eine INI-Datei aufgebaut und besteht aus Feldname = Feldinhalt, der „Header" heißt Fields, mehr Informationen zur FFF Datei finden sie hier. |
*.sss (StepOver Signature Set Datei) | Dateipfad oder URL | Wenn ein StepOver Signatur-Set übergeben wird, wird dieses aktiviert, sobald der Anwender in den Signaturmodus wechselt. D.h. er kann sich das Dokument zunächst in Ruhe ansehen und nach dem Wechsel in den Signaturmodus mit dem Unterschreiben beginnen. Mehr Informationen zur SSS Datei finden sie hier. |
*.ret (return Datei) | Dateipfad | Wenn Sie wissen möchten, welche Signaturfelder der Anwender ausgefüllt oder ob er den Signaturvorgang abgebrochen hat, können Sie als weiteren Parameter den Pfad zu einer *.ret Datei angeben. Diese wird von eSignatureOffice neu erstellt. eSignatureOffice trägt hier ein, welche Signaturfelder unterzeichnet wurden. Eine *.ret Datei ist wie eine INI-Datei aufgebaut. Sie enthält für jedes Signaturfeld einen Abschnitt und den Eintrag signed=1 für ein ausgefülltes Signaturfeld oder signed=0 für ein Signaturfeld, bei dem der Anwender auf „Abbrechen" gedrückt hat. Außerdem gibt es einen Abschnitt [MAIN] mit dem Eintrag Signed=1 oder Signed=0. Dieser Eintrag gibt an, ob alle Pflichtfelder ausgefüllt wurden (signed=1) oder ob eines der Pflichtfelder durch einen Klick auf "Abbrechen" übergangen wurde (signed=0). Mehr Informationen zur RET Datei finden sie hier. |
-autostartsig | Möchten Sie, dass der Benutzer nach dem Start von eSignatureOffice automatisch in den Signaturmodus gelangt und sofort mit dem Unterschreiben beginnen kann, müssen Sie nur zusätzlich den Parameter "-autostartsig" übergeben. | |
| Gruppen Name | Wenn man Unterschriften gruppiert, kann man optional auch den Gruppennamen beim autostartsig Parameter verwenden. Bsp: -autostartsig=GroupName | |
-autostartpdf | Möchten Sie, dass der Benutzer nach dem Start von eSignatureOffice automatisch in den PDF-Formularmodus gelangt und sofort mit dem Ausfüllen von Formfeldern beginnen kann, müssen Sie diesen Parameter übergeben. | |
| -autosave | Beim Schließen des Dokumentes wird automatisch gespeichert. | |
(PDF Datei) | Dateipfad oder URL | Eine als Startparameter übergebene PDF-Datei wird gleich nach dem Start in eSignatureOffice angezeigt. |
*.xml (Datei) | Dateipfad oder URL | Container Datei im XML Format welche u.a. das Dokument, Signaturfelder, Formfelder und Einstellungen enthalten kann. Mehr Information zum XML finden sie hier. |
| -password=<passwort> | Ist der Zugang zu eSignatureOffice mit einem Passwort geschützt (optionales „Sicherheitsfeature"), so kann dieses Passwort im Rahmen eines automatisierten Signaturvorgangs über Kommandozeile übergeben werden. | |
| -tcp=<IP>:<port> | Mit diesem Parameter kann auf einem Terminalserver bei Programmstart die IP und der port zur Kommunikation mit dem Client festgelegt werden. Eine genauere Anleitung dazu finden Sie hier: TCP/IP Installation und Nutzung: Konfiguration von IP und Port per Startparameter |
Erklärung zu den Parametern
Die Groß- und Kleinschreibung sowie die Reihenfolge, in der Sie die Parameter übergeben, spielen keine Rolle. eSignatureOffice ordnet diese entsprechend selbständig.
Einige Funktionen/Einstellungen der erläuterten Startparameter können Sie unter „Optionen | Administration…" ebenfalls antreffen. Wird aber eSignatureOffice aus verschiedenen Anwendungen heraus gestartet und soll dann verschiedene Eigenschaften aufweisen, so ist das Arbeiten mit Startparametern unverzichtbar.
Generelles Beispiel:
Es empfiehlt sich, die einzelnen Startparameter in Anführungsstrichen zu übergeben, da Pfadangaben u.a. auch Leerzeichen enthalten können.
Ein Aufruf von eSignatureOffice könnte also wie folgt aussehen:
"C:\Program Files (x86)\StepOver\eSignatureOffice 5.0\SOSigOffice.exe" "SaveDoc" "C:\Config.scs" "C:\My Testfiles\Test.pdf" "C:\Signaturset.sss" "C:\Form.fff" "C:\My Testfiles\Return.ret" "-autostartsig" "deactivate0110" "-page=3" oder "C:\Program Files (x86)\StepOver\eSignatureOffice 5.0\SOSigOffice.exe" "C:\My Testfiles\Test.pdf" "C:\Signaturset.sss"