HomeUsing LincDoc 3.0Connecting to Other SystemsLincDoc Connector to Laserfiche

14.2. LincDoc Connector to Laserfiche

Overview

The LincDoc Connector is a Java-based Windows service that allows LincDoc to write documents and data to external systems. In this documentation, Laserfiche connectivity will be discussed in detail. Other connectivity includes file share access, as well as other document management systems. The connector has an auto-update feature which communicates with your LincDoc server to retrieve the most up-to-date version for your software configuration. The high level steps to set up Laserfiche communication are:

  • Install 32 bit Java SE 6 JRE (even if using a 64 bit server OS).
  • Install the LincDoc Laserfiche Connector module.
  • Create the Laserfiche connection on the LincDoc Server.
  • Create and configure Laserfiche handler.
  • Create and configure LincDoc Connector.
  • Click Start to start the connector.

Laserfiche Connector module installation

LincDoc is based on Linux and Java. Laserfiche is based on Windows. In order for LincDoc to effectively integrate with Laserfiche, it must work with the Laserfiche Toolkit which is also based on (Windows only) COM technology.

This machine must already have the Laserfiche (thick) client installed (or more typically, it can be a Laserfiche server machine).

Hardware and Software Requirements

  • Windows machine that has the Laserfiche client or server already installed.
  • User must have full Administrator rights to install any additional software.
  • Java SE 6 JRE 32 bit installed - Click to download.
  • Note: turn off auto updates for the Java installation.

Detailed installation steps

Follow these steps to install the LincDoc Connector. Note: If you purchased and have installed a SSL certificate from a Certificate Authority (CA) (such as DigiCert, VeriSign, GoDaddy, etc...) for your LincDoc VM you do not need to perform step 3. By default, new LincDoc virtual machines DO NOT have one of these certificates installed. If you are unsure whether the server you are connecting to has a SSL certificate from a CA installed, please email support@lincware.com or call 585-563-1669option 2.
  1. Verify a 32 bit Java Runtime Environment (JRE) is installed (even if the OS is 64 bit). Type java -version from a Windows command prompt. You will see a version number if a JRE is installed. If you see 'java' is not recognized as an internal or external command then you will have to search the c: drive for java.exe, cd into the java.exe's directory (screenshot below), then rerun the command. What you should NOT see is something like java version "1.6.0_18" Java(TM) SE Runtime Environment (build 1.6.0_18-b07) Java HotSpot(TM) 64-Bit Server VM (build 16.0-b13, mixed mode) << note how this specifically says "64-Bit".
  2. Verify the JRE's automatic updates are turned off:
    1. Open your Control Panel and select the Java icon.
    2. On the Update tab, uncheck the "Check for Updates Automatically" check box.
    3. Select Never Check on the warning dialog message.
    4. Select OK to save your changes.
    5. Verify that the setting was changed by selecting the Java icon and viewing its setting.
  3. If a SSL certificate has not been installed to the LincDoc VM:
    1. Go to the LincWare System Administrator page.
    2. Go to the "download .exe to install SSL certificates for Java on Windows" section and click on the link.
    3. A new window will open with further installation instructions and a download button.
    4. Download and run the install-.lincware.com-https-cert-java-32.exe file from lwsa.
  4. Download the connector_setup.exe from here.
  5. Run connector_setup.exe.
  6. Click Next> or set the install path location (default: C:\Program Files\LincWare\Connector).
  7. Click install to install the Windows service.
  8. Click Next> on the LincDoc Connector Setup: Completed screen.
  9. Click Close to close the setup and launch the Connector configuration screen.

Note: if the LincDoc Connector configuration screen does not launch it is because a valid Java Runtime Environment is not installed.

LincDoc Connector - Service Configuration

The LincDoc Connector - Service Configuration is a small Java application which allows an administrator to start and stop the 3rd party windows service, as well as configure the LincDoc connector.

The first thing to do upon executing the configuration application is to set the URL of your LincDoc VM. Select Test to determine if the URL that you have entered is correct, and that the LincDoc server is running. The next step is to ensure that the Windows Service is registered. To check this, look at the Status information. If the connector is registered, the status will be either Stopped or Running.

Note: When the connector is installed, it should automatically register the service. However, if it is unregistered for any reason, simply click Register to register the service with windows.

LincDoc Connector Components

The LincDoc connector has two components to its configuration, a handler and a connector. A handler defines the configuration of the local system LincDoc needs to write to. In this case, Laserfiche is the local system. The handler defines the server, path locations, and user credentials used to access the Laserfiche system. The connector defines the configuration parameters for connecting to the LincDoc system. Once both of these components are defined, the handler can be mapped to an individual connector.

LincDoc Server Connector Configuration

  1. Install the LincDoc Connector (see above).
  2. Login to LincDoc as the admin user.
  3. Press the Administrator icon in the upper right portion of the window, then switch client ID; choose the appropriate client ID.
  4. Select >system>connectors from the admin UI menu (towards the upper right portion of the window).
  5. On this screen, type in the ID for a new connector and click Add to create it. Note: connector IDs are case sensitive.
  6. Once the connector is added, right click on the connector. You should see something similar to this: 
  7. Select View passphrase to create a new password. You will need to copy and paste this password into the configuration screen for this connector.

Using the connector to view connection status

Once the connector is configured, you can use LincDoc to view any sessions using the connection. Additionally, you can set up a monitor to send out an alert if the connector can no longer communicate with the external system. Both of these actions are accomplished through LincDoc's connector menu.

 

Connector Configuration - Laserfiche

 Create and configure Laserfiche handler

  1. Select >Configuration>Add Handler>Laserfiche.
  2. Set the following attributes.
Attribute Description
Handler ID This is unique identifier that is used by the connector; note that this id is case sensitive
Version The Laserfiche version (7.2 and higher is supported)
Server This is the Laserfiche server name (127.0.0.1 can be used if installing directly on the Laserfiche server).
Repository The Laserfiche repository where the documents will be stored
Username The Laserfiche username that will be used to write the forms
Password The password for the above username
Volume The Laserfiche volume where the documents will be written.
LF Temp Folder The folder location where the connector will temporarily write forms prior to moving them to the final location.  This is to address any LF workflow locking issues.
Max Connections Maximum number of connections made from the Connector to Laserfiche
Max Wait (sec) Maximum number of seconds the Connector will wait for a connection to Laserfiche to free up
Allow LincDoc to override username This gives the connector the ability to use the username and password of the current LincDoc user

Create and Configure Laserfiche Connector

  1. Click on the Connectors tab.
  2. Select Configuration -> Add Connector from the menu.
  3. Set the attributes as in the table below.
  4. Click File|Save Configuration.
  5. Return to the launch screen and select Start.
Attribute Description
LincDoc URL The URL of the LincDoc server.  Note the full path location (http://<yourservername>/lincdoc)
Client ID The unique customer ID for your LincDoc server provided by LincWare.
Connector ID The unique ID for this connector - must be set for each form in LincDoc that will use this connector
Password The passphrase for the connector generated from inside LincDoc (from the connectors menu)
Handler The unique identifier create for the Laserfiche handler configuration
Description Description assigned to the connector that will be used for logging purposes
Connections The number of connections the connector will make to the LincDoc server
Enabled Check Enabled to enable the connector.  If it is not enabled, LincDoc will report an error when trying to use the connector.

Laserfiche Connector

LincDoc is based on Linux and Java. Laserfiche is based on Windows. In order for LincDoc to effectively integrate with Laserfiche, it must work with the Laserfiche Toolkit which is also based on (Windows only) COM technology. This machine must already have the Laserfiche (thick) client installed (or it can be a Laserfiche server machine). High level steps to be performed on the Windows machine:
  • Install the LincDoc Laserfiche Connector module
  • Create a Laserfiche handler
  • Create a LincDoc Connector
  • Configure each
  • Setup the Laserfiche connection in LincDoc

Knowledge Tags

This page was: Helpful | Not Helpful