Start-Parameter

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

ParameterValuesInfo

-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
window design” has been deactivated.
Different menus can be deactivated via "deactivateXXXX" i.e. they will be hidden. This
way, certain functions can be rendered inaccessible to the user.


The four “x” after the word “deactivate” stand for in this sequence:
1. The main menu right at the top of the window
2. The logo banner below the file menu
3. The toolbar with the zoom buttons below the logo banner
4. The menu bar on the right with the buttons for the different modes (signature mode etc.)


In order to deactivate one of the above-mentioned menus, place a 1 at the
corresponding position in order to have it displayed a 0. The command Deactivate1001
deactivates the main menu and the button on the right in eSignatureOffice.
Deactivate1111 deactivates all four menu bars. The deactivated menu bars will also be
hidden. If the right menu bar is deactivated, the buttons needed for signing will be
displayed beneath the document. If using the command Deactivate1111, only the
displayed document will appear in a window on the screen as well as the buttons
“Signature Mode”, “OK”, “Cancel” and “Repeat”, or if necessary “Skip” and “Back”.
Despite this, you can use all functions, such as signature sets and macro buttons triggered
by signature sets.

-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
"width" or "w" = that means fit to page width.

-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
"width" or "w" = that means fit to page width

'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>IntegerParameter 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

ParameterValues Info
-lang=<Ing>D,GB, ES, NL, PL, F, IT, USThis 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
user without an enquiry, as opposed to the command [Options |Import].


It´s possible to provide a multiple SCS Version as Startparameter, in that case the Versionnumber needs to be added like:

 -scs="122|C:\config.scs" "135|C:\config.scs" "139|C:\config.scs" -scs="C:\config.scs"

  • In case the Version number is higher than the actual installation the SCS will be ignored
  • If there are more than 1 possible SCS, the highest supported Version will be used
  • In case the eSignatureOffice Version is older than August 2017 (eSignatureOffice 5.4), the Version specific SCS Version will be ignored (no support for Version specific SCS handover).
-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=integerThis 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>integerThis 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=StringThis 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=integerset 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)

ParameterValues Info
-cdc=local path or urlFilename of the Certificate to use as CDC
-cdcpw=stringPassword 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=stringDefinition of Private Key Alias (if more than one certificates in file), omit if not used

Workflow Integration

ParameterValues 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

(PDF File)

local path or urlPDF 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 urlcompressed 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

 ParameterValues 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

 ParameterValues Info
-autodigsig=0,1,2

controls the behavior of automatic DigSig field usage.

0 = Off

1 = Ask user

2 = Always use

-adsdefault=local SSS-fileDefault 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

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

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" 

C:\Program Files (x86)\StepOver\eSignatureOffice 5.0\SOSigOffice.exe  "C:\My Testfiles\Test.pdf" "C:\Signaturset.sss"