7.Startparameter
- Andy Erd
To start eSignatureOffice from another application you must call up the file "SOSigOffice.exe". You can transfer different parameters to this file when calling it up, the order of the Parameter doesn´t matter.
If you don’t know in which directory eSignatureOffice is located, you can find the save location with the following registry entry:
HKEY_LOKAL_MACHINE\SOFTWARE\STEPOVER\ESIGNATUREOFFICE X.XX\PATH (under 64Bit: HKEY_LOKAL_MACHINE\SOFTWARE\Wow6432Node\STEPOVER\ESIGNATUREOFFICE X.XX\PATH )
Display & Design
| Parameter | Values | Info |
|---|---|---|
-left=<integer_value> | integer | If you don’t start eSignatureOffice in full screen mode, here you can define the xcoordinates to determine the preferred position of eSignatureOffice when running. |
-top=<integer_value> | integer | If you don’t start eSignatureOffice in full screen mode, here you can define the ycoordinates to determine the preferred position of eSignatureOffice when running. |
| -width=<integer_value> | integer | If you don’t start eSignatureOffice in full screen mode, here you can define the width to determine the preferred position of eSignatureOffice when running. |
-height=<integer_value> | integer | If you don’t start eSignatureOffice in full screen mode, here you can define the height to determine the preferred position of eSignatureOffice when running. |
-gm0 -gm1 -gm2 -gm3 -gm4 | Allows you to use the “old” window design, which is necessary for some of the Display&Design Parameters. "-gm0" = traditional "-gm1" = traditional minimalistic "-gm2" = classic "-gm3" = classic reduced "-gm4" = New GUI (Eso V5.x) | |
-hideframe | The window frame will be hidden. (only working with OLD GUI, see -gm0) | |
-hidestartwin | When opening an application - be it manually, transferring via the PDF converter or by starting eSignatureOffice through the parameter "eSOSigOffice.exe" from another application - a window will appear for a short time which signals to the user that eSignatureOffice has started running. You can hide the start window using the command “-hidestartwin". | |
| -hidesignbtn | The button "Signature Mode” will not be displayed. | |
| -hidesupportbtn | The button "Support" in the Info-Form will not be displayed. | |
| -support | The support form is displayed right after start and load of command line documents (for "Mail to Support") | |
-hidesofcname -hsn | hides the title of the eSignatureOffice | |
deactivateXXXX -deactivateXXXX deactivate=XXXX -deactivate=XXXX | This option only has effects on the “old” window design i.e. if the “new
| |
-zoom= | integer/string | Using this parameter you can specify the document zoom when starting the program. "10" ... "300" = Zoom in percent "fit" or "f" or "0" = that means fit to screen or |
| -zoomaftersign= | integer/string | Using this parameter you can specify the document zoom after signing (even when canceling. "10" ... "300" = Zoom in percent "fit" or "f" or "0" = that means fit to screen or 'k' or 'keep' or Empty string when no change should occur - the zoom before starting the signature is used |
| -zoomlcd= | Integer | Defines zoom value on the (Colour) Device when document view is enabled at startup. Value in range 0..2, 0 = Fit to Width 1 = Fit to LCD (complete Page) 2 = maximal possible Zoom on Device |
| -minimize | start the application minimized | |
| -maximize | start the application maximized | |
| -monitor=<MonitorIndex> | Integer | Parameter allows you to set on which monitor the application should be placed |
| -editcorners | re-enables the dialog to pre-define and edit Corner-Patterns. If a pre-defined Corner-Pattern is defined in SSS this function is always used in the search for the edges of the signature-field | |
-hidesssfiles | no SSS file selection possible in new GUI | |
| -hidesssmenu | no Toolbox-Menu for SSS file creation/change/directory set | |
| -hidesss | hides SSS file selection and Menu for SSS | |
| -mds | enables the button for manual device search inside the administration. This button is only necessary if you using a very old com device. | |
| -nocentersign | in signature mode, when scrolling inside the document, the signature field rectangle is centered if a timeout or the user starts to sign. This behavior is unwanted when using MsInkPads or Tablets. With this parameter the centering is prohibited if signature rectangle is visible on monitor completely. | |
| -noscrollsign | Disable scrolling in eSignatureOffice while signature mode | |
| -overlapped | Parameter for SecureSign when used with SigFile function. In this mode function sigFile is terminated immediately after call, while eSignatureOffice keeps running in background. Calling application must meet special requirements, please refer to SecureSign documentation. | |
| -chkresize | Parameter for SeucreSign when used with SigFile funtion. When used with overlapped the window resize check is not enabled, which can cause problems. | |
| -setfocus | Force eSignatureOffice into focus at startup |
Behaviour or basic settings
| Parameter | Values | Info |
|---|---|---|
| -lang=<Ing> | D,GB, ES, NL, PL, F, IT, US | This command allows you to set the eSignatureOffice language automatically. |
savedoc -savedoc | The parameter SaveDoc is delivered to eSignatureOffice by e.g. the StepOver PDF Converter. eSignatureOffice then assumes that the opened PDF file is a temporary file and will accordingly ask upon closing the application whether the file should be saved, even if it has not been changed. Clicking the "Save" button once will in this case result in "Save As ..." Dialogue. | |
| -sofcrenameto=<file_name> | This command is relevant if a signed document is to be saved automatically with a macro button. This can be done either by activating a visible macro button or through an invisible button that will be activated automatically by a signature set after signing. With the help of this command you can now change the file name to which the signed document is to be saved. The parameter then changes the file name of the original or, if necessary, the name that was indicated during configuration of the macro button under "after copying change file name to ". | |
| -stayontop | If eSignatureOffice is always in the foreground while the program runs, you can access this function through the parameter “-stayontop”. Thus other opening applications always remain in the background. eSignatureOffice can now only be minimised by clicking “Minimise” in the box top right. | |
-scs=<file> *.scs (Configuration-Set-File) | local path or url | A StepOver Configuration Set file (*.scs) is one that can contain all eSignatureOffice settings e.g. settings for macro buttons, user rights, or for security & Key Management, etc. Please refer to the chapter "eSignatureOffice Administration" Export settings An *.scs file delivered as start parameter will immediately import to the It´s possible to provide a multiple SCS Version as Startparameter, in that case the Versionnumber needs to be added like:
|
| -multi | Using this parameter, it is possible to start several instances of eSignatureOffice at once. | |
| -nodrawdata | Ensures that no information is saved above the signature characters in the PDF, thus reducing the file size. | |
| -nobiodata | Ensures that no biometric data is saved to the signature in the PDF or TIFF document. Within the document, only the signature image is saved. This also reduces the file size slightly after signature. The command “nobiodata” contains nodrawdata. | |
| -pdfnobiodata= | local path | saves the biodata free version of the PDF into the local file. This file is not erased at end of application. |
| -df= | integer | This command is also used to reduce the file size; to do so, each N measuring point of the signature is ignored. With the indication “-df=5”, every fifth dot on the signature image is not registered. With the indication “-df=2”, for example, only half of all measuring points would be analysed. |
| -page=<pagenumber> | integer | This command enables you to indicate the page which is to be displayed on the opened PDF. |
| -printonly | The print dialogue box opens straight after starting eSignatureOffice. | |
| -dkf= | String | This command allows you to set the pad type to be used. At the present time, the two indications "-dkf=naturaSignPad" or "-dkf=nsp" are possible. These can be used to limit usage on the naturaSign Pad. |
| -nodocumentview | prevents the pad from displaying the document | |
| -allowskipandabortlastsig | enables the skip and abort at last signature | |
| -epc | Enable Pad Open check | |
| -brightness= | integer | set brightness of pad (0-100) f.e. "-brightness=40" |
| -rotate | Rotate all pages in the PDF document right 90 degrees. Please be aware, that this parameter will be ignored, if there are already any digital signatures within the document! Otherwise, these signatures would be invalidated due to the changed PDF structure! | |
| -rotate=<Degree> | integer | rotate all pages clockwise in the PDF document by <Degree> could be 90,180 or 270 "-rotate=90" is the same as "-rotate" Please be aware, that this parameter will be ignored, if there are already any digital signatures within the document! Otherwise, these signatures would be invalidated due to the changed PDF structure! |
-PadRotateStart=<orientation value> | integer from 0 to 5 | Rotates the view on the connected and selected signature pad as soon as the program is started. The orientation values defines the direction. No change = 0 Landscape = 1 (this is the default orientation) Landscape (left handed) = 2 Portrait (upright view) = 3 Portrait (left handed) = 4 Please take note, that this works only for already configured devices (so it does normally NOT work for the very first start with a newly connected signature pad)! |
-PadRotateEnd=<orientation value> | integer from 0 to 5 | Rotates the view on the connected and selected signature pad as soon as the program closed. The orientation values defines the direction. No change = 0 Landscape = 1 (this is the default orientation) Landscape (left handed) = 2 Portrait (upright view) = 3 Portrait (left handed) = 4 Set to the starting value = 5 (this will set the pad to the orientation, which it had when the program was started) Please take note, that this can of course work only correctly, if the program is terminated correctly. |
Custom Device Certificate (CDC)
| Parameter | Values | Info |
|---|---|---|
| -cdc= | local path or url | Filename of the Certificate to use as CDC |
| -cdcpw= | string | Password used to access the Certificate(s) in the file, omit if not used. |
| -cdcpubka= | string | Definition of Public Key Alias (if more than one certificates in file), omit if not used |
| -cdcprivka= | string | Definition of Private Key Alias (if more than one certificates in file), omit if not used |
Workflow Integration
| Parameter | Values | Info |
|---|---|---|
-fff=<file> *.fff (Form Field Filler File) | local path or url | Such a file contains the names of the form fields of a PDF file that are to be filled in, as well as their value or text. During start-up, eSignatureOffice automatically fills in the PDF’s form fields and shows the filled-out PDF file. Specifying a *.fff-file only makes sense in connection with specifying the corresponding PDF file. This *.fff-file is constructed like an INI file and consists of field name = field content, the "header" is called fields. You can get more Infos about the FFF file here. |
-sss=<file> *.sss (StepOver Signature Set File) | local path or url | If a StepOver signature set is transferred, it is activated as soon as the user switches to signature mode. This means that he/she can first look at the document in peace and start signing after switching to signature mode. You can get more Infos about the SSS file here. |
-ret=<file> *.ret (return file) | local path | (only in connection with the specification of a signature set file) If you would like to know which signature fields the user has filled out, or whether he/she has cancelled the signature process, you can specify the path to a *.ret file as a further parameter. This is newly created by eSignatureOffice . eSignatureOffice enters here which signature fields have been signed. A *.ret file is constructed like a INI file. You can read more about the RET file here. |
-autostartsig | (only in connection with the specification of a signature set file). If you wish the user to access signature mode automatically after starting eSignatureOffice and immediately be able to start signing, you must deliver the additional parameter "autostartsig". No use of signature group | |
| -autostartsig= | group name | (only in connection with the specification of a signature set file). If you wish the user to access signature mode automatically after starting eSignatureOffice and immediately be able to start signing, you must deliver the additional parameter "autostartsig". The signature group with the name "group name" is used, if white space are present in the name, surround with double-quotes f.e. -autostartsig="Group Name" |
-autostartpdf | If you wish the user to access the PDF form mode automatically after starting eSignatureOffice and thus be able to start filling in form fields immediately, you must deliver the additional parameter "autostartpdf". The parameter "autostartpdf" disables some Buttons like Viewmode and Administration. | |
| -autostartformfill | only activates form fill mode, without disabling other functionality (other than "autostartpdf" Parameter") | |
| -autostartmacroX | automatic start of macro (sample -autostartmacro1 .... -autostartmacro10) | |
| -autosave | It is automatically saved when closing the document. | |
-pdf=<file> (PDF File) | local path or url | PDF file delivered as a starting parameter will be displayed immediately after start-up in eSignatureOffice. |
-xml=<file> -exml=<file> *.xml (XMLFile) | local path or url | XML file delivered as a starting parameter will be displayed the PDF inside it immediately after start-up in eSignatureOffice. You can read more about the RET file here. |
-zip=<file> *.zip | local path or url | compressed file |
| -password=<password> | If access to eSignatureOffice (optional "safety feature") is password-protected, then this can be delivered within the frame of an automated signature procedure with a command line. | |
-varN= (N is a integer value) | string | This parameter allows you to input variable into eSignatureOffice which can be used for Macro functionality or the Stamp. You can find more details here. |
| -addsearchhistory | search history is added to RET file and/or XML Output | |
| -mds | reactivate manual device search button in Administration / General tab | |
| -bfcadddoc | This parameter will trigger the processing of already existing documents in your watchdog folder after the start of eSignatureOffice. By default existing documents would be ignored and only documents which are added during the runtime would be processed. |
Automatic SSS-File Selection
See also using automatic SSS-File selection
| Parameter | Values | Info |
|---|---|---|
| -asssfile= | 0,1,2 | controls the behavior of automatic file selection. 0 = Off 1 = Ask user 2 = Always select |
| -asssselect= | 0,1 | controls the usage of found SSS-files for document 0 = always use first document 1 = Ask User if more than one SSS-file is found |
DigSig Fields
See also using automatic DigSig fields
| Parameter | Values | Info |
|---|---|---|
| -autodigsig= | 0,1,2 | controls the behavior of automatic DigSig field usage. 0 = Off 1 = Ask user 2 = Always use |
| -adsdefault= | local SSS-file | Default SSS-file settings |
| -adspreview= | 0,1 | controls the clickability of the digsig fields in preview of document 0 = No click 1 = Yes, you could click onto an digsig field in preview and the corresponding DigSig field signing is activated |
| -adspdf= | 0,1 | controls the clickability of the digsig fields in the document view area 0 = No click 1 = Yes, you could click onto an digsig field in document view and the corresponding DigSig field signing is activated |
| -adssignature= | 0,1 | controls the double-clickability of the digsig fields in the signature panel 0 = No double-click 1 = Yes, you could double-click onto an digsig field in signatures panel and the corresponding DigSig field signing is activated |
| -adsclick= | 0,1 | controls the (double-)clickability of the digsig fields in the signature panel, view area and preview 0 = No (double-)click 1 = Yes, you could (double-)click onto an digsig field in document view, preview and signatures panel and the corresponding DigSig field signing is activated |
| -sssmanual | 0,1,2 | controls direct click onto a digsig field inside preview/document view 0 = do not sign 1 = ask user 2 = always sign |
Explanation
Capitalisation or use of small letters as well as the sequence in which you deliver the parameters is not important. eSignatureOffice will allocate them accordingly. Some functions/settings of the explained starting parameters can also be found under the Administration (or Startmanager.exe). However, it is essential to work with start parameters if eSignatureOffice is started from different applications and is to display different features.
Samples
It is advisable to deliver the individual start parameters within quotation marks as path indications may also contain spaces.
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" C:\Program Files (x86)\StepOver\eSignatureOffice 5.0\SOSigOffice.exe "C:\My Testfiles\Test.pdf" "C:\Signaturset.sss"