7. Startparameter

Ü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
Mittels „-deactivateXXXX" deaktiviert man verschiedene Menüleisten, d.h. sie werden ausgeblendet. Auf diese Weise können bestimmte Funktionen für den Anwender unzugänglich gemacht werden.
Die vier „X" hinter dem Wort „deactivate" stehen in dieser Reihenfolge für:

  1. Das Hauptmenü ganz oben im Fenster
  2. Das Logo-Banner unter dem Dateimenü
  3. Die Toolbar mit den Zoomknöpfen unter dem Logo-Banner
  4. Die Menüleiste rechts mit den Schaltflächen für die verschiedenen Modi (Signaturmodus usw.) und Makroschaltflächen.


Um eines der oben genannten Menüs zu deaktivieren, setzen Sie an der entsprechenden Position eine 1, um es angezeigt zu lassen eine 0. Der Befehl Deactivate1001 deaktiviert also das Hauptmenü und die Schaltflächen rechts in eSignatureOffice. deactivate1111 deaktiviert alle vier Menüleisten. Die deaktivierten Menüleisten werden auch optisch ausgeblendet. Wenn die rechte Menüleiste deaktiviert wird, werden die für das Unterzeichnen notwendigen Schaltflächen unterhalb des Dokumentes angezeigt. Mit dem Befehl deactivate1111 erscheint dann nur noch das angezeigte Dokument in einem Fensterrahmen auf dem Bildschirm sowie die Tasten „Signaturmodus", „OK", „Abbrechen" und „Wiederholen" oder ggf. „Überspringen" und „Zurück". Sie können dennoch sämtliche Funktionen wie Signatursets und durch Signatursets ausgelöste Makroschaltflächen verwenden.

-zoom=

ganze ZahlMit 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
"width" oder "w" = Seitenbreite

'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 ZahlDefiniert 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, FMit 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 URLEine 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 ZahlDieser 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 ZahlMit 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 ZahlMit 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

(PDF Datei)

Dateipfad oder URLEine 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:

Beispiel
"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"