Laserfiche Connector Test Utility

The Laserfiche Connector Test Utility lets you quickly determine if Laserfiche Connector will work with an application. The Test Utility also generates log files that can help Laserfiche troubleshoot any potential problems.

Tip: We have already confirmed compatibility with these applications for gathering information and these applications for writing data.

To integrate Laserfiche Connector with a Java application on a Windows system, you must have Java JRE installed. Additionally, Laserfiche Connector requires that Java Access Bridge (known as JAB) version 2.0.2 or later is enabled.

How to use the Test Utility

Important: We recommend testing the Laserfiche Connector on a sample or generic page in your application. For example, if you are testing case management software, create a sample case for the test instead of testing it on actual client information. The XML log file created during testing will record all information from the application's screen. Since this log file is often used for troubleshooting (either within your organization or with Laserfiche support professionals), you don't want to inadvertently expose sensitive client information through this file.

To test getting information from an application

  1. Download the latest version of the Test Utility from the Laserfiche Support Site.
  2. Extract the contents of the downloaded ZIP file.
  3. Open the Laserfiche Connector Test Utility by double-clicking LFC.TestUtility.exe.
  4. Next to Analyze window select one of the following:
    • Use JavaScript to find controls: The JavaScript method should be used with most desktop applications and with websites displayed in Internet Explorer, Firefox, and Chrome. If you cannot select the controls you want with JavaScript, try the UI automation method.
    • Use OCR to extract text: This option gets the text directly from the window using optical character recognition. It does not interact with the controls on the page.

      • Tip: The OCRParameters.xml file (located in the same folder as the Test Utility) lets you configure advanced options to optimize OCR accuracy and speed during your tests. Learn more about these OCR options.

    • Use UI Automation to find controls: Most applications let you select controls using JavaScript. However, UI automation may be needed for some applications, or it may let you select different controls than JavaScript does.
  5. Drag the target to the application you want Laserfiche Connector to work with. If the current window title of the application appears in the utility, Laserfiche Connector will be able to analyze the application.
  6. Click Next.
  7. You'll have one of two options for gathering information from the application, depending on if you chose to analyze the window with JavaScript, UI automation, or OCR.
    • If you chose OCR, click the Select text button and then draw a rectangle around the text you want to extract. The OCRed text will appear next to OCRed text.
    • If you chose JavaScript or UI automation, drag the target to the field you want to retrieve data from. Use the drop-down menu next to Field value to see the information that is gathered from each part of the field's control. If Laserfiche Connector cannot select the fields you want, try the following:
      • Click Back in the Test Utility, and select a different option next to Analyze window. The JavaScript method should be used with most applications and with websites displayed in Internet Explorer, Firefox, and Chrome. For other applications and browsers, JavaScript and UI automation may let you select different controls and may make different field values available.
      • If you are trying to use Laserfiche Connector with Internet Explorer, an application with Internet Explorer controls, Chrome, Firefox, or a Java-based application, additional configuration may be required. Learn more.
  8. Fill out the Application Compatibility form to let us know the results of your test.

To test writing information to an application

  1. Download the latest version of the Test Utility from the Laserfiche Support Site.
  2. Extract the contents of the downloaded ZIP file.
  3. Open the Laserfiche Connector Test Utility by double-clicking LFC.TestUtility.exe.
  4. Next to Analyze window select one of the following:
    • Use JavaScript to find controls: The JavaScript method should be used with most desktop applications and with websites displayed in Internet Explorer, Firefox, and Chrome. If you cannot select the controls you want with JavaScript, try the UI automation method.
    • Use UI Automation to find controls: Most applications let you select controls using JavaScript. However, UI automation may be needed for some applications, or it may let you select different controls than JavaScript does.
  5. Drag the target to the application you want Laserfiche Connector to work with. If the current window title of the application appears in the utility, Laserfiche Connector will be able to analyze the application.
  6. Click Next.
  7. Drag the target to the field you want to write information into. If Laserfiche Connector cannot select the fields you want, try the following:
    • Click Back in the Test Utility, and select a different option next to Analyze window. The JavaScript method should be used with most applications and with websites displayed in Internet Explorer, Firefox, and Chrome. For other applications and browsers, JavaScript and UI automation may let you select different controls and may make different field values available.
    • If you are trying to use Laserfiche Connector with Internet Explorer, an application with Internet Explorer controls, Chrome, Firefox, or a Java-based application, additional configuration may be required. Learn more.
  8. In the Value to write field, type the value you want to write into the control. If this field is disabled, then the control you selected cannot be written into. Try selecting a blank text box or other write-able control in the target application. Learn more about the control types that are supported by Laserfiche Connector.
  9. Click Write value to edit control.
  10. Fill out the Application Compatibility form to let us know the results of your test.

How to find the log files

The log files are stored in the c:\Users\[Username]\Documents\Laserfiche Connector folder. Logs files will be created each time the utility runs. Included in this folder is an XML file that gathers all information on the page of the application that's being tested. If you selected to OCR the window, a screenshot may be included in this folder as well.