JViews Diagrammer Release Notes

This document describes the main changes that have been made to the JViews Diagrammer module since version 6.5.

Incompatibilities
General Changes
Library Changes
New Packages
New Interfaces and Classes

• ilog.views.bpmn.IlvBPMNFlowValidator
• ilog.views.diagrammer.application.IlvDiagrammerAction.FileAction
• ilog.views.diagrammer.faces.dhtml.interactor.IlvFacesDiagrammerSelectInteractor
• ilog.views.diagrammer.servlet.IlvDiagrammerMoveNodeActionListener
• ilog.views.diagrammer.servlet.IlvDiagrammerSelectionActionListener
• ilog.views.diagrammer.servlet.IlvDiagrammerSelectionSupport

Modified Classes

• ilog.views.bpmn.IlvBPMNUtilities
• ilog.views.diagrammer.IlvDiagrammer
• ilog.views.diagrammer.application.IlvDiagrammerAction
• ilog.views.diagrammer.application.IlvDiagrammerPaletteAction
• ilog.views.diagrammer.application.IlvDiagrammerPropertySheet
• ilog.views.diagrammer.application.IlvDiagrammerStatusBar
• ilog.views.diagrammer.faces.dhtml.servlet.IlvFacesDiagrammerServletSupport
• ilog.views.diagrammer.servlet.IlvDiagrammerServletSupport
• ilog.views.graphlayout.bus.IlvBusLayout
• ilog.views.sdm.IlvSDMEngine
• ilog.views.sdm.model.IlvDefaultSDMNode
• ilog.views.sdm.renderer.IlvInteractorRenderer
• ilog.views.sdm.renderer.IlvStyleSheetRenderer
• ilog.views.sdm.renderer.maps.IlvMapRenderer
• ilog.views.sdm.servlet.IlvSDMServlet
• ilog.views.sdm.servlet.IlvSDMServletSupport

Tag Library Changes
Example Changes

Incompatibilities

• The classes DiagrammerObjectSelectedFinder and DiagrammerObjectSelectedRectFinder have been renamed IlvDiagrammerObjectSelectedFinder and IlvDiagrammerObjectSelectedRectFinder respectively.
• IlvDiagrammer: methods writeData(), writeDataFile(), and writeProjectFile(URL) throw IlvDiagrammerException only. In previous releases, they threw IOException as well. This change generates a compile error when the methods are overriden. It can be fixed by removing the additional thrown exception.
• The constructors of the IlvBPMNMakeSDMLinkInteractor and IlvBPMNSDMUtilitiesFactory now require an IlvBPMNModeler parameter. Therefore, you have to derive your BPMN Modeler from the IlvBPMNModeler class, instead of deriving it directly from IlvDiagrammerApplication

General Changes

The main general changes of the JViews Diagrammer module are the following:

• Diagrammer Designer:
  • New expression assistant, when editing a value in a customizer.
  • Ability to add custom functions.
  • New ability to add variables. Variables are basically key/value pairs, defined in a dedicated CSS rule. The variables are substituted by their value in expressions.
  • Added the "create link" button in data mode toolbar, even if the data doesn't contain a link yet.
  • Wizards are simplified.
  • Usability improvements.

• SDM
  • Map renderer: new property to control whether fitToContent is performed.
  • Interaction renderer: new property to ignore mouse move events.
  • IlvGeneralLink: LineStyle property now accepts JViews standard names (Solid, Dash, Dot...).
  • Class declaration in style sheet now accepts a function call, e.g. "class: @|createMyObject(@foo,20);".
  • New property in IlvSDMEngine allowing you to couple the link visibility to the visibility of the origin and destination nodes.
  • IlvLinkLayoutRenderer: the CSS specification of the node sides to which links are allowed to connect can now be done on a per-node basis, not only on a per-link basis. For details, see the documentation of this class.

• Graph Layout
  • Bus layout: new customization capabilities.

• BPMN
  • Improvement in swimlanes.
  • Support of the Data Object and Group artifacts.
  • Support of Flow validation rules. You can add your own Flow validation rules and remove one or more predefined ones.
  • When creating flows, the interactor only highlights valid source or target objects according to the chosen flow type and source objet.
  • The Group action removes flows that become invalid after the grouping operation.
  • The Group action is not enabled if the selected objects are in different lanes.
  • The Conditional Flow does not have the mini-diamond when it is outgoing from a Gateway.
  • The provided BPMNModeler class now derives from the new IlvBPMNModeler class instead of IlvDiagrammerApplication.
  • The associations.xml palette file is replaced by artifacts.xml, it also contains the Data Object and Group.
  • The Text Annotation must have its ArtifactType SDM property set to Annotation.

• DHTML JavaServer Faces components changes:
  • A popup menu component that can be set on a JViews Diagrammer view component has been added.
  • A generic data property has been added to the JViews Diagrammer view component.
  • The interactor invocation context property allows interactor actions to be executed in the JSF lifecycle context or in the image servlet context.
  • A select interactor has been added to easily select and/or move one or several nodes or links without a page refresh.
  • To make the use of image maps easily, the image map area generator is now a property of the diagrammer view component.

Library Changes

New Packages

No new package.

New Interfaces and Classes

ilog.views.bpmn.IlvBPMNFlowValidator

Validates if a Flow can connect two objects, using a list of Flow Rules.

ilog.views.diagrammer.application.IlvDiagrammerAction.FileAction

A base class for I/O actions

ilog.views.diagrammer.faces.dhtml.interactor.IlvFacesDiagrammerSelectInteractor

A diagrammer specific implementation of IlvFacesSelectInteractor.

ilog.views.diagrammer.servlet.IlvDiagrammerMoveNodeActionListener

This class defines a server action dedicated to translate the current selection.

ilog.views.diagrammer.servlet.IlvDiagrammerSelectionActionListener

This class handles selection requests in image mode.

ilog.views.diagrammer.servlet.IlvDiagrammerSelectionSupport

This class is the IlvSelectionSupport implementation dedicated to the diagrammer.

ilog.views.event.adapter.IlvLinkVisibilityHandler

The IlvLinkVisibilityHandler ensures that links are only visible if their end nodes are visible.

Modified Classes

ilog.views.bpmn.IlvBPMNUtilities

• New methods:
  • isArtifact(IlvSDMModel, Object): Tests if an object is an Artifact.
  • isDefaultFlow(IlvSDMModel, Object): Tests if the given object is the Default.
  • isEndEvent(IlvSDMModel, Object): Tests if an object is an EndEvent.
  • isLane(IlvSDMModel, Object): Tests if an object is a Lane.
  • isPool(IlvSDMModel, Object): Tests if an object is a Pool.
  • isSequenceFlow(IlvSDMModel, Object): Tests if the given object is a SequenceFlow.
  • isStartEvent(IlvSDMModel, Object): Tests if an object is a StartEvent.

• New methods:
  • isEmpty(): Tests if the diagrammer is empty.

• New methods:
  • getDefaultResourceBundle(): Returns the default resource bundle used if no resource bundle is specified in the constructor.

ilog.views.diagrammer.application.IlvDiagrammerPaletteAction

• New methods:
  • getPaletteDiagrammer(): Returns the diagram component used as the "source" from which nodes or links are copied.
  • getPaletteObject(): Returns the source object that is copied when creating an object.

ilog.views.diagrammer.application.IlvDiagrammerPropertySheet

• New methods:
  • addTargetPropertyChangeListener(PropertyChangeListener): Add a listener that will be notified of the target's modifications.
  • allowUserDefinedType(boolean): Allows you to install or not install the action which allows the user to set the user-defined type for the selected object.

ilog.views.diagrammer.application.IlvDiagrammerStatusBar

• New constructors:
  • IlvDiagrammerStatusBar(boolean): Creates a new status bar with the default resource bundle "ilog.views.diagrammer.application.statusbar".

ilog.views.diagrammer.faces.dhtml.servlet.IlvFacesDiagrammerServletSupport

• Overview of new features:
  • This ServletSupport now manages popup menu requests.

• New methods:
  • getMenuFactory(HttpServletRequest, HttpServletResponse): Retrieves or creates the menu factory used in this popup menu request.

ilog.views.diagrammer.servlet.IlvDiagrammerServletSupport

• New constructors:
  • IlvDiagrammerServletSupport(ServletContext): Creates a new diagrammer ServletSupport.

ilog.views.graphlayout.bus.IlvBusLayout

• Overview of new features:
  • New option for placing the nodes below the bus line instead of above.
  • New option for adjusting the extremity points of the bus line.

• New methods:
  • getNodePosition(): Returns the node position option.
  • setNodePosition(int): Sets the position of the nodes in respect to the bus line.
  • isBusLineExtremityAdjustingEnabled(): Returns true if the adjustment of the extremity points of the bus line is enabled.
  • setBusLineExtremityAdjustingEnabled(boolean): Enables the adjustment of the extremity points of the bus line.

• New fields:
  • NODES_ABOVE_BUS: Position the nodes above the bus.
  • NODES_BELOW_BUS: Position the nodes below the bus.

ilog.views.sdm.IlvSDMEngine

• Overview of new features:
  • Added the possibility to control the visibility of a link according to its edge visibility.

• New methods:
  • isLinkNodeVisibilityCoupled(): Returns true when links are visible, if and only if the origin and destination nodes are visible.
  • setLinkNodeVisibilityCoupled(boolean): Sets whether link visibility is coupled to node visibility.

ilog.views.sdm.model.IlvDefaultSDMNode

• New methods:
  • getChildrenCount(): Returns the number of children this data object has.

ilog.views.sdm.renderer.IlvInteractorRenderer

• Overview of new features:
  • Added the possibility to bypass mouse motion events for better performance.

• New methods:
  • isProcessMouseMoveEvents(): Returns true if MouseMove events are processed.
  • setProcessMouseMoveEvents(boolean): Sets ProcessMouseMoveEvents.

ilog.views.sdm.renderer.IlvStyleSheetRenderer

• New methods:
  • unregisterFunction(IlvSDMCSSFunction): Removes a given function.

ilog.views.sdm.renderer.maps.IlvMapRenderer

• New methods:
  • getInstance(IlvSDMEngine): Convenient function to get the IlvMapRenderer instance which belongs to the specified SDM engine.
  • isFitToContentsAllowed(): Returns whether fitToContent() is performed during PrepareRendering() processing.
  • setFitToContentsAllowed(boolean): If true, PrepareRendering() performs a fitToContents().

ilog.views.sdm.servlet.IlvSDMServlet

• New methods:
  • createServletSupport(ServletContext): Creates the supporting object to which this servlet delegates most of its methods.

ilog.views.sdm.servlet.IlvSDMServletSupport

• New constructors:
  • IlvSDMServletSupport(ServletContext): Creates a new SDM servlet support in mono-session mode.

Tag Library Changes

• The JViews Diagrammer JavaServer Faces tag library has been updated:
  • Several attributes have been added to the diagrammerView tag:
    • A data attribute has been added. It specifies the data to display. It can be:
      • A Designer for JViews Diagrammer project.
      • An XML file.
      • An IlvDiagrammerDataSource.
      • A dataSource component ID instance.
    • The imageMapGenerator and imageMapGeneratorClass attributes have been added to specify the object responsible for generating the image map areas.
  • The diagrammerView now accepts as a child the jvf:contextualMenu component used to display a popup menu on the diagram view.
  • An invocationContext attribute has been added to the nodeOrLinkSelectInteractor and nodeOrLinkSelectRectInteractor tags to specify in which context the action should be executed.
  • A selectInteractor tag has been added. It specifies an interactor that allows you to easily select and/or move several node or links.

Example Changes

• The JavaServer Faces code fragments have been redesigned. The examples are here.
• A new JavaServer Faces sample has been added to demonstrate the selection interactor. The sample is here.
• The App6a demo has been transferred to the JViews Maps for Defense product.