Protocol Application Presence Detection
DocManager functions for document opening provide a callback parameter to be executed if no required protocol is installed on a client machine. If the protocol is not installed, the callback function is executed. In this callback, you will typically request a protocol application installation and will redirect to the installer download, depending on the client's OS.
As soon as every OS requires its own installer, the IT Hit WebDAV Ajax Client library provides DocManager.GetInstallFileName() function that returns installer file name depending on OS on which the client code is executed. The WebDAV Ajax Library is provided with protocol applications for Windows, macOS and Linux, that are located in the /Plugins/ folder in the archive.
Below is typical callback implementation:
ITHit.WebDAV.Client.DocManager.EditDocument("https://server/folder/file.ext", "/", protocolInstallCallback);
// Called if protocol handler is not installed
function protocolInstallCallback(message) {
var installerFilePath = "/Plugins/" + ITHit.WebDAV.Client.DocManager.GetInstallFileName();
if (confirm("This action requires a protocol installation. Select OK to download the protocol installer.")){
window.open(installerFilePath);
}
}