Perforce JViews Diagrammer Sample: Generic Modeler

Description

This sample shows the code needed to build a simple business process modeler using a diagram component.

How to Use the Sample

• A hotline process is loaded automatically when the example starts.
• Use the Choose a style sheet box to try the different style sheets. This shows how the same data model can be represented differently using the styling capabilities of Perforce JViews Diagrammer.
• Create a new process by clicking the New button in the top horizontal toolbar.
• Click the * icon (Create node of type "resource") in the middle horizontal toolbar.
• Click inside the Unnamed window to create a node.
• Click a second time inside the Unnamed window, a second resource node is created.
• Click the last button (Create link of type "tool link") in the middle horizontal toolbar.
• Click the first node that you created, then the second node to create a link between these nodes.
• Repeat steps above to create other nodes and links.
• Click the arrow button (Make Select Active) in the vertical toolbar on the left of the panel.
• Select and move the nodes.
• Use the buttons in the vertical toolbar on the left of the panel to zoom and pan the view.
• Click the Layout All Nodes button in the top toolbar to place the nodes automatically according to the link hierarchy.
• Save your diagram using the Save icon or the File>Save menu item.
• The top horizontal toolbar provides the usual editing operations: cut, copy, paste, undo, redo, and so on
• You can open sample process diagrams, they are located in the "data" directory.

How to Run the Sample as an Application

This sample can be run as an application. The installation directory contains an executable JAR file, diagrammer-modeler.jar, that allows you to execute the sample with a double click from a file browser. Note that if you are using Internet Explorer, you can open the installation directory and execute the JAR file from the browser. This technique may not work in other Web browsers.

Alternatively, you can run the sample application from the command line. First check that the Ant utility is properly configured. If not, see the instructions on how to configure Ant for Perforce JViews.

Then, go to the installation directory of the sample and type:

ant run

Topics Covered

• Create a simple multidocument diagram editor using a diagram component.
• Use the IlvDiagrammerApplication class to create a simple business process editor.
• Create a toolbar to control the diagram view.

Detailed Description

This sample shows the code needed to build a simple business process modeler using a diagram component.
The sample uses the base class IlvDiagrammerApplication. The palette and the style sheets are specialized to display and edit BPM processes.
Several style sheets are provided with this example. You can change the style sheet using the Choose a style sheet box. This shows how Perforce JViews Diagrammer can be used to display the same data model for different look and feel without changing your code.

Installation Directory

The Generic Modeler sample is installed here.

Classes Involved

• ilog.views.diagrammer.IlvDiagrammer

  The main class of the diagram component.

• ilog.views.diagrammer.application.IlvDiagrammerApplication

  The predefined base class for Perforce JViews Diagrammer applications.

Source Files

• ProcessModeler

  The entry point of the sample.