Configuring Third-party Applications for Laserfiche Connector
The primary use of Laserfiche Connector is to interact with a third-party application. If you want Laserfiche Connector to run from Chrome, Firefox, Microsoft Edge, a Java-based application, Internet Explorer, or an application that hosts Internet Explorer controls, some additional configuration is needed.
Note: If the third-party application is running as a Windows administrator, Laserfiche Connector must also run as a Windows administrator to get controls from the application.
Chrome
If you are running Laserfiche Connector from Chrome, you need to either configure a remote debugger for Chrome or render accessibility parameters, depending on if you selected Use JavaScript to detect controls or Use UI automation to detect controls in the profile wizard.
If you are using JavaScript
You can either use the Chrome Configuration Utility to automatically configure a remote debugger, or you can manually configure Chrome.
Chrome Configuration Utility
- Run the configuration utility. The utility is available from support@laserfiche.com. Learn more about the utility here: KB 1014056.
- Restart Laserfiche Connector.
- Restart Chrome.
Manually Configure Chrome
- Open Chrome's properties. Depending on the version of Windows you are running, there are a few ways to open Chrome's properties.
- Right-click Chrome in the Start menu and select Properties.
OR
- Right-click Chrome in the Start menu, point to More, and select Open file location. Right-click the shortcut in the opened file location, and select Properties.
- If Chrome is pinned to your taskbar or start menu, un-pin it.
- In the Chrome Properties dialog box, navigate to the Shortcut tab.
- In the Target text box, add a space after the last quotation mark and paste:
--remote-debugging-port=9222 --remote-allow-origins=localhost
Note: If you've changed the port number Laserfiche Connector uses, then replace 9222 with the updated port number. You can check the port number being used in the LFC.exe.config file (located in the Laserfiche Connector installation directory).
<setting name="ChromeRemoteServer" serializeAs="String">
<value>http://localhost:portnumber</value>
</setting>
- Click OK.
- Restart Laserfiche Connector.
- Restart Chrome.
If you are using UIAutomation instead of JavaScript
Configure the --force-renderer-accessibility parameter to run when chrome.exe starts. You can do this by adding the parameter to the target property of for each Chrome start shortcut.
- Open Chrome's properties by right-clicking Chrome in the Start menu and selecting Properties. If Chrome.exe is not in Start menu, drag it into Start menu and then open its properties.
- Configure the --force-renderer-accessibility parameter to run when chrome.exe starts. You can do this by adding the parameter to the target property of for each Chrome start shortcut.
- In the Shortcut tab, add --force-renderer-accessibility to the end of the contents in the Target text box. (Ensure there is a space between the target and the parameter.)
- Click Apply and restart the application. If Chrome is pinned to your taskbar, un-pin and then re-pin it.
Firefox
If you are running Laserfiche Connector from Firefox and you selected Use JavaScript to detect controls, you will need to configure Firefox's remote debugger.
- Open the LFC.exe.config file (located in the Laserfiche Connector installation directory). Confirm it has the following entry to allow remote debugging in Firefox:
- Copy the port number. (It will be used in step 8.) If you choose to change ports, the port number must be between 1 and 65535, and it is best not to use the common port.
- Open Firefox's debugger console. (From Firefox's menu, select More Tools, Web Developer and then Debugger.)
- Click the More options button . This button says Customize Developer Tools and Get Help on hover.
- Open Settings, and under Advanced Settings select the following two options:
- Enable browser Chrome and add-on debugging toolboxes
- Enable remote debugging
- In the browser's address bar, type about:config to open Firefox's configuration settings.
- Search for the keyword "prompt," and set devtools.debugger.prompt-connection to false using the toggle button to the right of the value.
- Open Firefox's properties by right-clicking Firefox in the Start menu, selecting More, and then Open file location. Then right-click the Firefox shortcut and select Properties.
- In the Shortcut tab, add -start-debugger-server portnumber to the end of the contents in the Target text box. (Ensure there is a space between the target and the parameter.) The port number must be the same as the port number in the LFC.exe.config file above.
- Click Apply and then OK.
- Restart both Firefox and Laserfiche Connector.
<setting name="FirefoxRemoteServer" serializeAs="String">
<value>localhost</value>
</setting>
<setting name="FirefoxRemoteServerPort" serializeAs="String">
<value>6000</value>
</setting>
Microsoft Edge
If you are running Laserfiche Connector from Microsoft Edge based on Chromium, and you selected Use JavaScript to detect controls, you will need to configure new Microsoft Edge's remote debugger.
- Open new Microsoft Edge's properties. Depending on the version of Windows you are running, there are a few ways to open new Microsoft Edge's properties.
- Right-click new Microsoft Edge in the Start menu and select Properties.
- Right-click new Microsoft Edge in the Start menu, point to More, and select Open file location. Right-click the shortcut in the opened file location, and select Properties.
OR
- If Microsoft Edge is pinned to your taskbar or start menu, un-pin it.
- In the Microsoft Edge Properties dialog box, navigate to the Shortcut tab.
- In the Target text box, add a space after the last quotation mark and paste:
- Click OK.
- Restart Laserfiche Connector.
- Restart Microsoft Edge.
--remote-debugging-port=9322 --remote-allow-origins=localhost
Note: The remote debugging port is 9322, not 9222 as specified by Microsoft, to ensure that Edge integrations do not conflict with Chrome integrations.
Note: If you've changed the port number Laserfiche Connector uses, then replace 9322 with the updated port number. You can check the port number being used in the LFC.exe.config file (located in the Laserfiche Connector installation directory).
<setting name="EdgeChromiumRemoteServer" serializeAs="String">
<value>http://localhost:portnumber</value>
</setting>
Java-based applications
To integrate Laserfiche Connector with a Java application on a Windows system, Java Access Bridge (known as JAB) version 2.0.2 or later must be enabled. Learn more.
Install and Enable Java Access Bridge
Java Access Bridge is included with Java SE Runtime Environment (JRE) version 7 update 6 (7u6) and later. Java Access Bridge 2.0.3 is included with JRE 7u6. If your JRE version is before 7u6, you may need to download the JAB installation package and install it manually. Learn more.
By default, Java Access Bridge is not enabled after installation, so you must enable it.
To enable Java Access Bridge, either:
- Run the following command (where %JRE_HOME% is the directory of your JRE):
- Restart Laserfiche Connector and all Java applications.
%JRE_HOME%\bin\jabswitch -enable.
OR
- For Windows Vista and later, you can enable Java Access Bridge through the Control Panel:
- Go to Start > Control Panel > Ease of Access > Ease of Access Center.
- Select Use the computer without a display.
- In the Other programs installed section, select the Enable Java Access Bridge checkbox (you may have to scroll down).
- Restart Laserfiche Connector and all Java applications.
Internet Explorer or an application that hosts Internet Explorer controls
When using Laserfiche Connector with Internet Explorer or an application with Internet Explorer controls, you may encounter a warning that says, "Internet Explorer restricted this webpage from running scripts or ActiveX controls," click "Allow blocked content" to proceed.
To avoid this error in the future, allow this blocked or ActiveX content with the following steps:
- Open Internet Explorer, go to Tools -> Internet Options.
- Click on Advanced tab, and scroll down to the Security section.
- Select the Allow active content to run in files on My Computer checkbox.
- Click OK.
- Close Internet Explorer (or the application with Internet Explorer controls) and restart it.
Other applications
If you run into problems analyzing and selecting controls in an application, please refer to related help documents for that application. You may need to turn on accessibility in the application, for example, by applying the --force-renderer-accessibility parameter to the target property of the application.