In order to run a Java application or applet for FileNet Workplace, you must deploy it on your Application Engine server.
Caution If you upgrade to a new FileNet Workplace or Process Engine version, you must redeploy all existing custom applications and applets. Existing applications/applets, including all Java Step Processors and Launch Step Processors, should be recompiled and then redeployed using the procedure below. If you get compiling errors, correct your custom Step Processor applications/applets, for example, by comparing them to the new version's sample Java Processors (see Java Step Processor Sample Files and Java Launch Step Processor Sample Files).
To deploy a Java application/applet, such as a custom Java Step or Launch Step Processor, on the Application Engine server, use the following procedure (for details, click on the step):
Note This procedure assumes that you have already installed the Process Development Environment (for information, see Installing the Process Development Environment and click on the appropriate link according to which FileNet web application you are using), have installed and configured the Java Runtime Environment (JRE), have compiled your application files, and have created and signed (with a Netscape Object Signing Certificate) a JAR file for your application/applet.
If you want to add a Java application/applet JAR file, e.g., for a custom Step or Launch Step Processor, once and use it for a number of different Step Processors, etc., perform the following steps:
Note All Process applications, including out-of-the-box, sample, and custom Step Processor applications, must be registered using the Configuration Console. For information, see Process Engine Administration Help.
This procedure explains how to create a JSP event page as part of the process of adding a Java application/applet, such as a customized Step Processor, to the Application Engine server, which in turn makes it available to Process Engine. Creating a JSP event page for a Launch Step Processor is a similar process, although the locations and file names are different (these differences are indicated in the procedure below).
Note This procedure assumes familiarity with the Application Engine Workplace framework, which is based on the Model-View-Controller (MVC) approach in a J2EE platform environment. Refer to the Web Application Toolkit Guide for additional information on the JSP event and view (UI) page structures and interaction.
Note For Launch Step Processors, go to the ...\Workplace\eprocess\launchers\java directory.
Note For Launch Step Processors, copy the ...\Workplace\eprocess\launchers\java\ootb\WcmLaunchSP.jsp file.
<%String jarVersionValues = com.filenet.wcm.toolkit.util.WcmBuildStamp.jarVersion
+ ", " +
filenet.vw.toolkit.utils.VWBuildStamp.jarVersion;%>
<%String jarVersionValues = com.filenet.wcm.toolkit.util.WcmBuildStamp.jarVersion
+ ", " +
filenet.vw.toolkit.utils.VWBuildStamp.jarVersion + ", " + "2.0.0.0";%>
<jsp:setProperty name="plugInModule" property="appletClassName" value="filenet.vw.apps.steps.tabbed.VWTabbedStepApplet" />
Modify this line to reflect the name of the package you used when compiling your sample Step Processor. For example, if your JAR file was created in the \newStep directory and the applet is named newStepApplet, your statement would be similar to:
<jsp:setProperty name="plugInModule" property="appletClassName" value="newstep.newStepApplet" />
<jsp:setProperty name="plugInModule" property="jarArchiveValues" value="wcm.jar, eProcess.jar" />
Modify this statement to add the name and location of the new JAR file. For example, if your custom jar file is named newSteps.jar, your statement would be:
<jsp:setProperty name="plugInModule" property="jarArchiveValues" value="wcm.jar, eProcess.jar, newSteps.jar" />
Note If you intend to use several JAR files, you should compile all of the JAR files into a single file and reference only one file. Alternatively, you can specify multiple JAR files using a comma (",") delimiter. Not all browsers support multiple JAR files. Also note that the JAR file must be signed (for details, see Signing a Jar File).
Create a JSP View page that corresponds to the JSP Event page you just created (see above), as follows:
Note For Launch Step Processors, navigate to the ...Workplace\UI-INF\jsp\ui\eprocess\launchers\java directory.)
Note For Launch Step Processors, copy the ...\Workplace\UI-INF\jsp\ui\eprocess\launchers\java\ootb\WcmLaunchSP.jsp file.
WcmString topic = new WcmString("server.WcmStepProc_jsp.topic", "Java Step Processor");
WcmString topic = new WcmString("server.myCustomStepProcessor_jsp.topic", "My Custom Step Processor");
At this point, you are ready to configure the server for the web application and add the new or updated Step Processor to the workflow.