OpenIDM 2.x does not have an administrative user interface (UI). As an alternative you can setup Eclipse to assist you is all the common tasks you have to perform during an OpenIDM deployment.
Here is a summary of the tools that you'll need:
- Eclipse IDE for Java EE Developers
This package includes:
Data Tools Platform
Eclipse Git Team Provider
Eclipse Java Development Tools
Eclipse Java EE Developer Tools
Maven Integration for Eclipse
Mylyn Task List
Eclipse Plug-in Development Environment
Remote System Explorer
Eclipse XML Editors and Tools
- JSON Editor
- Activiti Designer Plugin
- JSF Web Page Editor (Just the WPE, not the whole JSF tool set)
This workspace allows you to do virtually anything you may need like:
- Checkout, view, edit and compile the OpenIDM source code
- Build workflow processes, including a WYSIWYG HTML Editor for the forms*
- Build custom UIs
*There are currently no less than three ways to include forms in your Activiti workflows.
Use the standard Activiti form properties and have them automatically rendered in a generic fashion by our UI
Explicitly define a custom page to render it (and add other functionality), by embedding in the process definition (which ends up as ugly, hard to edit XML escaped HTML code)
Explicitly define a custom page to render it (and add other functionality), by using a 'form' defined in the UI artifacts, referenced via the formKey. This uses the regular UI templates/function libraries we have built, so it is very powerful and we provide some good high level functions and patterns to add fields etc, but with power also comes an amount of complexity.
- Start with an Activiti BPMN XML file (which can be auto generated by the Activiti Designer Plugin or you can start with a copy of an existing one)
- Make sure the file name ends in *.bpmn and not bpmn20.xml
- Replace the XML escaped HTML code with anchors like %PROCFORM% or %TASKFORM$:
Create *.proc.html and *.task.html web form files (you can copy and unescape the form from a sample file)
To make a new *.bpmn20.xml file, just run the custom builder (Projects -> Build Project, when prompted, double click the *.bpmn file).
The custom builder called insertXML.sh which calls HTML2XML.sh, replaces the anchors with properly escaped HTML code, and creates a new *.bpmn20.xml file.
To create the custom builder in Eclipse:
- Download the necessary shell scripts. (Warning, there is different code in insertXML.sh for MacOS and Linux. You may have to comment/uncomment accordingly)
- Unzip and place the scripts in an OpenIDM directory like /opt/openidm/samples/workflow/workflow
- In Eclipse, go to Project -> Properties
- Click "Builders" on the left pane.
- Click "New" button
- Select "Program"
- Under "location", enter the path to the script
- Under "Working Directory", enter the path to the directory with the *.bpmn, *.proc.html and *.task.html file
- Click the "Varinables" button
- Select "file_prompt" (no arguments are required)
- Click OK
- Name the Builder whatever you like
- Click OK