Link Handler
Mine Type
The eSO Setup sets a Mine Type (Link Handler) to the SOSigOffice.exe to start eSO with a Link. The URL is eso:// and it can also contain all the StartParameter of the SOSigOffice.exe. To seperate the Parameter a | must be used.
This is working in Offline Application and in the Main Browsers (IE, Firefox, Chrome, Safari, Opera), in most of them the User gets a Warning/Message which he needs to accept.
Sample
eso:// | Starts eSO |
eso://-pdf=https://www.stepoverinfo.net/eSO-Samples/Mustermann.pdf|-sss=https://www.stepoverinfo.net/eSO-Samples/Mustermann.sss | Starts eSO with PDF and SSS, which will be downloaded |
eso://c:\Mustermann.pdf|-autostartsig|-stayontop | It also works with local files |
Registry Entrys for the Link-Handler (only required when not using the Setup)
To use that we add the following Registry Entry.
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\eso] @="URL:eso protocol" "URL Protocol"=""
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\eso\DefaultIcon]
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\eso\shell]
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\eso\shell\Open]
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\eso\shell\Open\Command] @="\"C:\\Programme\\StepOver\\eSignatureOffice\\SOSigOffice.exe\" \"%1\""
Additional information for Firefox:
As of version 122.0 (currently the most recent version) the Firefox browser has a bug which deletes the colon in the PDF download path, which makes a message appear that the PDF cannot be found.
To fix this problem, replace this colon with "%3A".
So our example URL will look like this:
Additional setting for Chrome:
Open "Preferences" of Chrome, you can find it under %LOCALAPPDATA%\Google\Chrome\User Data\Default\Preferences
Close Google Chrome.
Open the Preferences file and search for
excluded_schemes
inprotocol_handler
.Add the line
"eso": false,
to
excluded_schemes
.Restart Google Chrome.