Configure the COM Bridge
This topic describes how to configure the JiGlue COM Bridge on a development
system. Configuring the JiGlue COM Bridge consists of the following basic steps:
The remainder of this topic provides procedures on how to perform each of these
steps.
Configure JDK, CLASSPATH, and Register the jiglue.dll
To use the JiGlue COM Bridge, if you have not already done so, you must first
install the appropriate Java SDK on your development system (the JDK version
varies depending upon your OS). For information on which JDK to use and how
to configure a JDK on a development system for Panagon eProcess, see the Configure
the Java SDK topic. Once you have installed the JDK, you must specify the
location of the pw.jar file (contains the eProcess APIs), and register
the jiglue.dll file on your system.
If you are planning to develop COM applications on your Web WorkFlo server,
you have typically already installed your JDK, configured your CLASSPATH, and
the jiglue.dll was registered during eProcess installation; skip to the
Deploy the Client Application procedure.
If you are planning to develop an application on a system that is neither your
workflow server or Web WorkFlo server, use the following procedure:
- If you have not already done so, install the appropriate Java SDK on your
development system. In order to use the JiGlue COM Bridge, you should install
the JDK in the default directory (on Windows, the default installation directory
is <drive>...\jdk1.3.1; on Solaris <drive>:/j2sdk1.4.0
(for JDK 1.4.0), etc.). For information on installing the JDK and configuring
your system for eProcess development, see the Configure
the Java SDK topic.
- Create a local directory (in any location) called \process. You will
use this directory to hold the eProcess Developer files, including pw.jar
and the JiGlue files.
- Copy the jiglue.dll, jiglue.tlb, and pw.jar files to
the \process directory. In order for JiGlue to work correctly, all
three of these files must be in the same directory (as they are as shipped
on the Panagon eProcess Toolkit CD). Refer to the Panagon
eProcess Toolkit topic for information on these files and where to find
them.
- If you have not already done so on this system, configure the CLASSPATH
to specify the pw.jar location (typically either by creating a batch
file to include pw.jar in the CLASSPATH, or if you are developing using
an IDE (such as Visual Cafe, JBuilder, Forte, etc.), by adding pw.jar
to your global or project setting). For details, see the Configure
the Java SDK topic.
Note The jiglue.dll parses the CLASSPATH for the location
of the pw.jar file. If JiGlue does not find pw.jar in the
CLASSPATH:
- The JiGlue library attempts to find the registry key: HLM\Software\FileNET\Panagon
eProcess Services - Web WorkFlo\Extras.
- If the library cannot find this registry key, jiglue.dll uses
the default <drive>...\WF_Extras path, appends pw.jar
to it, and adds the location to the CLASSPATH for the running JVM
process.
- If jiglue.dll does not find any registry entry, the library determines
the path to jiglue.dll and assumes the pw.jar is located
in the same directory. JiGlue appends pw.jar to its own location
in the path and adds the location to the CLASSPATH for that instance of
the JVM.
- Open a command prompt, and cd to the \process
subdirectory.
- Register jiglue.dll by entering
the following at the command prompt:
regsvr32.exe jiglue.dll
Tip You can unregister the library by entering the following command:
regsvr32.exe /u jiglue.dll
Deploy the Client Application
If you are developing on the Web WorkFlo server, you do not need to register
the jiglue.dll and you do not need to install the JRE. Both steps were
done during installation.
If you are developing a new ASP-based application or extending the current
ASP application, the appropriate JiGlue COM Bridge configuration already exists
on the eProcess Web WorkFlo server. However, if you are developing stand-alone
workflow applications (which are sometimes referred to as work performers) and
you plan to deploy them on client systems, your installer must perform the following
steps:
- Install or check for an existing installation of the JRE (currently for
the client, JRE 1.4.0). Both JRE\bin and JRE\bin\client must
be in the system path.
- Create a new directory to contain the process components.
- Copy the jiglue.dll, jiglue.tlb, and pw.jar files to
the new directory (all three of these files must be in the same directory).
- Register the jiglue.dll (see Step 6 above).