Troubleshooting Laserfiche Connector

These are the most common Laserfiche Connector errors and questions. See system administration level errors.

Q: What should I do if a profile's status says "Invalid profile" in the Laserfiche Connector Configuration dialog box?

This status means that the profile could not be successfully validated by the ProfileSchema.xsd file. Review the profile XML file for errors.

How to check for XML errors with XMLNotepad:

  1. Open the XML profile in XMLNotepad. Learn how to find the XML profile.
  2. Click View > Schemas, and add the ProfileSchema.xsd file. This XML schema file is in <installation directory>\Laserfiche\LFConnector on machines on which the Laserfiche Connector Process Creator was installed. Ensure the .xsd file is not disabled in the dialog box.
  3. Click OK. Any validation errors will appear in the error list.

Q: What should I do if a profile's status says "Duplicate" in the Laserfiche Connector Configuration dialog box? Alternatively, why don't my copied profiles appear when I click the embedded Laserfiche Connector button?

If you copied a profile or the application information in a profile, the profile will be listed as "Duplicate" in the Laserfiche Connector Configuration dialog box and will not appear when you click the embedded Laserfiche Connector button. If you want to edit and use the copied profile, change the FlowDef IDs in the XML to unique values.

Q: A user selected "Remember me" when signing in to the Laserfiche Repository Windows Client. Now they want to sign in as a different user, how can I clear the "remember me" setting?

See the Clear saved sign in information section of the Configuring Laserfiche Connector Profiles help topic.

Q: What should I do if I get a "cannot read value of specified control error"?

Sometimes Laserfiche Connector may not be able to read the value of a specific control, causing this error to occur and interrupting Laserfiche Connector's action. Examine the application to see if anything has changed with the control in question. You may need to remap the control if this error occurs frequently. Alternatively, you can configure the Laserfiche Connector profile to always ignore this error for a specific control. Learn more.

Q: Why is my Laserfiche Connector search not returning the correct documents?

After trying to run the search from Laserfiche Connector, open the Search Pane in the Laserfiche Repository and show the Advanced search box. The search syntax Laserfiche Connector ran will be displayed in this box. Laserfiche Connector will search on the exact values from the application's controls unless wildcards are added to the search query. You can update the search query by editing the profile. Learn more.

Q: Why is the Laserfiche Connector button not appearing in my target application?

If the Laserfiche Connector button does not appear in the application you expect it to, check the following:

  • Open the Laserfiche Connector Configuration dialog box (right-click the Laserfiche Connector icon in the notification section of the taskbar and select Configuration) and ensure the profile related to the button is listed there and the status is OK. If the profile has been deleted, the button will have disappeared as well. If the status is invalid, see the instructions here.
  • In the Laserfiche Connector Configuration dialog box, click the Options button. Ensure that Display Laserfiche Connector icon on windows is checked.
  • Double-click the related profile in the Laserfiche Connector Configuration dialog box. In the profile, find the <AppDef> element and check that these attributes: wclass, wtitle, pname, and url match the target application. Learn more.
  • The profile associated with the button may be disabled. Learn how to enable a profile.
  • The button's icon might have been hidden during configuration. Find the <AppDef> element, and ensure the showIcon attribute is set to true.
  • Try restarting the application, and see if the button is still missing.

Q: I configured Laserfiche Connector to automatically get values from multiple applications, so why is it prompting users to manually navigate between the applications?

Laserfiche Connector will default back to manual navigation whenever it cannot get values automatically. Laserfiche Connector cannot automatically get values in the following situations:

  • The user has closed the target application, web page, or window that Laserfiche Connector needs to get values from.
  • Multiple windows or web pages meet the criteria for being the target page. For example, if multiple windows have the same name or you've used regular expressions to define the target page and multiple pages meet the criteria, then Laserfiche Connector won't know which page to get values from.
  • The target window or web page has an action running on it making it busy or unavailable to Laserfiche Connector.
  • The target web page is open in an un-selected tab.

Because automatically retrieving values can fail for so many reasons, it's important to provide detailed instructions on the Get Information page of the wizard. These instructions can guide the user to manually complete the process.

Tip: If the user dismisses or misses the instructions, they can right-click the Laserfiche Connector icon in the notification section of the task bar and select View pending actions. A list of the actions pending user input will open, including instructions for completing the actions.

Example: Laserfiche Connector gets information from a Human Resources application and the company's directory website. Then, it uses that information to search the repository. Generally, the user has both the Human Resources application and the directory website open when they run the Laserfiche Connector profile, so the search results are displayed immediately after the Laserfiche Connector button is pressed. However, if a user closes the directory website and then runs the profile, instructions will appear on the screen prompting them to open the website and click the Continue button to complete the action.

Q: I configured Laserfiche Connector to scroll and screenshot a page or portion of a page, but the resulting image is missing segments. How do I fix this?

Sometimes if Laserfiche Connector scrolls the page too quickly it isn't able to capture the entire image. You can slow down the scroll rate to improve accuracy. The scroll rate is controlled by the CaptureInterval attribute in the profile's XML file. Learn more.