Eclipse for Web application development
After the configuration of the server and database a dynamic Web project with Process Manager facets activated can be created in Eclipse. This project contains all relevant artefacts, like JARs and configurations, to run the Stardust Portal in the Web application of this project. The Workflow Execution Perspective can be started without any further configuration after Web application server start.
Create a Dynamic Web Project
To create a new dynamic Web project in Eclipse:
- On the main menu select File > New > Project....
- In the upcoming wizard choose Web > Dynamic Web Project.
Figure: Creating a New Dynamic Web Project
- Click Next.
- In the properties page enter a name for your Web project.
- Make sure that the target runtime is set to Apache Tomcat with the currently supported version.
If not, please set up the Apache Tomcat server as described in the section Configuring the Server of the previous chapter.
- Select Dynamic web module_version 2.4 or 2.5, as 3.0 is currently not supported by Stardust.
- In the Configurations entry, select Stardust Portal for Dynamic web module 2.4 or Stardust Portal for Dynamic web module 2.5 respectively in the drop down list. The facets provided with this configuration can be added or removed later as described in section .
Figure: Setting Dynamic Web Project Properties
Now choose the folder for your java sources, the default is src. Leave or adjust the default output folder and select Next.
Figure: Set Build Path.
The next dialog gives you the opportunity to configure Web module settings. If you want to use the default settings, just choose Next.
- The default context root is the name of your project, optionally choose another name.
- The default name of the content directory for your Web project is WebContent. Optionally choose another name.
- Select Next.
Figure: Configure Web Module Settings
The next dialog is the JSF Capabilities dialog, where you enter the following values:
- JSF Implementation Library: Disable Library Configuration
- JSF Configuration File: /WEB-INF/faces-config.xml (or a custom config file)
- JSF Servlet Name: Faces Servlet
- JSF Servlet Classname: javax.faces.webapp.FacesServlet
- URL Mapping Patterns: /faces/*
Now click Finish.
A dialog opens to ask if the perspective should be changed. The J2EE perspective is optional, so click No.
Figure: Change the perspective
As the facet is contained in the Stardust Portal configuration, you have to set the repository path as described in the section Setting the Repository Path of the Document Service Integration Guide.
After creating the dynamic Web project, the folder structure will look like in the example below. A top level folder is created for the project and the project files are initialized.
Figure: New Dynamic Web Project in the Package Explorer
Process Manager Facets
Beside the Stardust Process Facet itself, Stardust provides several facets to add or remove functionality, e.g. to your Stardust Workflow Execution Perspective:
- Process Manager - Diagrams - enables the Diagram functionality in the Workflow Execution Perspective. Please refer to the Stardust Portal documentation for detailed information.
- Process Manager - Jackrabbit (Embedded Repository incl. Server Option) - deploy Jackrabbit with the application (the embedded option is used if no Jackrabbit exists). Please refer to the section The Process Manager - Jackrabbit Facet of the Document Service Deployment chapter for detailed information.
- Process Manager - Jackrabbit (Remote Repository Client) - deploy Jackrabbit with the application (the Remote option is used when the Web application is supposed to be connected to an existing Jackrabbit deployment.)
- Process Manager - Portal - the Process Manager - Portal facet. Please refer to the Stardust Portal chapters for detailed information.
- Stardust Process Reporting - enables the Reporting functionality in the Workflow Execution Perspective. Please refer to the Business Analysis and Reporting guide for detailed information.
Please note that the Process Manager - Portal facet requires the JavaServer Faces facet.
Adding and Removing Facets
You can add or remove facets in the Projects Facets properties dialog by selecting the corresponding project facets. To add or remove project facets to your project:
- Right-click your project and select Properties.
- In the properties dialog select Project Facets.
- On the right side all available facets are listed, which you can enable or disable.
- In case of disabling (thus deleting) facets, confirm the dialogs asking to remove the according facet folders, e.g.:
Now you can create a model or import an existing one in the new dynamic Web project. Please refer to the chapter The Process Workbench of the Modeling Guide to get information on how to create and import models in the Process Workbench.
Java classes added to the project for applications or data in the process model are also available in the runtime environment.
Adding and Removing Jackrabbit Facets
As some files could be locked by the server process, please stop your server before adding or removing Jackrabbit facets. Restart it afterwards.
Upgrading Process Manager Facets
If you have a dynamic Web project with an earlier Stardust version, upgrade the Process Manager facets you are using. You can select the version in a drop-down list.
- Open the projects's properties dialog.
- Select Project Facets.
- Select the facets to update and choose the according facet version in the drop down list.
- Click Apply.