The PJAC and Toolkit Installation CD includes a Process Development Environment for developers. The Process Development Environment for the FileNet Web Services web application consists of a set of JAR files that contain the Java API runtime classes, Process API samples, sample HTML and Java Step Processor applets/applications (available for customization), and library and toolkit files.
Subtopics include:
The Process Development Environment for FileNet Web Services consists of (for further details, see Process Development Environment Contents below):
Prerequisites: This procedure assumes that you have already installed FileNet Web Services and the Process Engine and that you have run the PJAC installer and have installed PJAC for FileNet Web Services.
To install the Process Development Environment on your development system, use the following procedure (if you are working on a web server on which PJAC has been installed, much of this procedure has already been done by the PJAC installer):
Note The locations listed in this topic may vary from the actual location on the Installation CD. If you have difficulty locating the ...\Developer Files folder, search for the MainSample.java file on the Installation CD. This should help you find the ...\Developer Files\Samples\API folder location on the CD.
pw.jar
vwpanel.jar
jiglue.dll (needed in order to use the JiGlue COM Bridge for a COM application)
jiglue.tlb (needed in order to use the JiGlue COM Bridge for RAD development)
The contents of the ...\Developer Files\Samples directory
Note If you are not on a FileNet Web Services server, in order for JiGlue to work correctly, the pw.jar file and the JiGlue library files must be in the same directory. The JiGlue jiglue.dll and jiglue.tlb library files can also be found in the ...\FileNet\IDM\PWBin directory.
If you followed the default Process Engine installation procedure, have run the PJAC installer, and followed the installation procedure above, the Process Development Environment files should be located on your FileNet Web Services server (or your development system, if the same) in a directory structure contained in the <drive>...\Program Files\FileNet\IDM\Web\IDMWS\Redist directory and on your development system in a directory structure contained in the <drive>...\Developer Files directory, respectively.
As shown in the table below, included with the Process Development Environment are a set of default Java and HTML Step Processor applet and application files. These applets and applications provide a model of how to use the Process Java APIs, FileNet Web Services, and the JiGlue COM Bridge (HTML only) and are available for customization.
The default Process Development Environment directory structure for FileNet Web Services consists of the following directories and files:
Directory | Description of Contents |
---|---|
On the PJAC and Toolkit Installation CD under the ...\FileNet\IDM\Web\IDMWS\Developer Files directory: |
|
\Developer Files |
Contains the following development files: pw.jar: Contains the Process Engine Java API runtime classes, plus client classes, Task Manager classes, third party classes [e.g., for Xerces], etc. The pw.jar file should reside on the Process Engine server (if there are multiple Process Engines, pw.jar should be on each Process Engine), each client, and if used, on the Process Analyzer. vwpanel.jar: Includes the information and Java Step Processor UI Toolkit classes which may be used for Rapid Application Development (RAD) drag-and-drop functionality to customize the user interface in a Java Integrated Development Environment (IDE), such as IDEA, JBuilder, etc. For information on how to use these Toolkit packages and classes, see the Java Step Processor UI Toolkit API JavaDoc documentation. jiglue.dll: The dynamic link library used to enable Java - COM communication (also called the JiGlue COM Bridge). jiglue.tlb: The JiGlue type library. |
Includes the following subdirectories: \API: Contains sample Process Java API files that may be used to create, launch, complete, display, save log information, etc. for a workflow and that illustrate how to use the Process Java APIs. \vwpanel: Contains the sample Java Step Processor application files (in the ...\vwpanel\samplestep subdirectory) and Java Launch Step Processor sample files (in the ...\vwpanel\samplelaunch subdirectory) along with the image files (.gif files) needed for the default user interface. \Utils: Contains a Java class that allows you to view or remove entries from the Java (Remote Method Invocation) RMI registry. |
|
On the FileNet Web Services server under the <drive>...\Program Files\FileNet\IDM\Web\IDMWS\Redist directory: |
|
\Redist |
Default HTML (ASP) Step Processors: |
Includes the following ...\Redist subdirectories containing the HTML (ASP-hosted) Step Processor and Launch Step Processor samples: \WF_Step\html: Contains sample HTML (ASP) Step Processor files. \WF_Launcher\html: Contains sample HTML (ASP) Launch Step Processor files. \WF_Html_Toolkit: Contains shared files for the sample HTML (ASP) Step and Launch Step Processors. Subdirectories include:
|
|
ASP container files for the sample Java Step Processor applets: | |
Includes the following ...\Redist subdirectories containing the ASP container files for the sample Java Step Processor and Launch Step Processor applets: \WF_Step\tabbed\step_main.asp: ASP container file for the sample Java Step Processor applet. \WF_Launcher\tabbed\launcher_main.asp: ASP container file for the sample Java Launch Step Processor applet. |