JViews Diagrammer 8.7 Release Notes

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

Incompatibilities
General Changes
Library Changes

New Interfaces and Classes

• ilog.views.diagrammer.faces.dhtml.interactor.IlvFacesDiagrammerLinkInteractor
• ilog.views.diagrammer.faces.dhtml.interactor.IlvFacesDiagrammerResizeInteractor
• ilog.views.diagrammer.faces.dhtml.renderkit.IlvFacesDiagrammerLinkInteractorRenderer
• ilog.views.diagrammer.faces.dhtml.renderkit.IlvFacesDiagrammerResizeInteractorRenderer
• ilog.views.diagrammer.faces.dhtml.taglib.IlvFacesDiagrammerLinkInteractorTag
• ilog.views.diagrammer.faces.dhtml.taglib.IlvFacesDiagrammerResizeInteractorTag
• ilog.views.diagrammer.servlet.IlvDiagrammerLinkActionListener
• ilog.views.diagrammer.servlet.IlvDiagrammerResizeActionListener
• ilog.views.sdm.renderer.IlvCachedLinkConnectionRectIndex
• ilog.views.sdm.renderer.graphlayout.IlvGraphLayoutEditor

Modified Classes

• ilog.views.dashboard.IlvDashboardAction
• ilog.views.diagrammer.servlet.IlvDiagrammerSelectionSupport
• ilog.views.graphlayout.circular.IlvCircularLayout
• ilog.views.graphlayout.hierarchical.IlvHierarchicalLayout
• ilog.views.graphlayout.hierarchical.IlvSwimLaneConstraint
• ilog.views.graphlayout.tree.IlvTreeLayout
• ilog.views.graphlayout.uniformlengthedges.IlvUniformLengthEdgesLayout
• ilog.views.sdm.IlvSDMEngine
• ilog.views.sdm.graphic.IlvDefaultManagerFrameGraphic
• ilog.views.sdm.graphic.IlvURLGraphic
• ilog.views.sdm.renderer.IlvSDMLinkConnector
• ilog.views.sdm.renderer.IlvSDMClippingLinkConnector
• ilog.views.sdm.renderer.IlvSDMFreeLinkConnector
• ilog.views.sdm.renderer.IlvSDMRenderer
• ilog.views.sdm.renderer.graphlayout.IlvGraphLayoutRenderer
• ilog.views.sdm.renderer.maps.IlvMapRenderer

New JSF Components

• jvdf:resizeInteractor
• jvdf:linkInteractor

Modified JSF Components

• jvdf:diagrammerView

New JavaScript Classes

• IlvResizeInteractorProxy
• IlvLinkInteractorProxy

Incompatibilities

• All JViews product jars are now signed. This can result in a SecurityException if your application has classes in the same ilog.* packages as the JViews library. You can either repackage your application so that it no longer shares packages with JViews or you can remove the signatures from the JViews jars. These files are the ILOGKEYS.* files in the jars META-INF directory.
• The method getLinkConnectionRectangle(IlvSDMEngine, IlvGraphic, IlvTransformer) of IlvSDMRenderer is final and should not be overridden. Instead, override the method getLinkConnectionRectangle(IlvSDMEngine, IlvGraphic, IlvTransformer, IlvLinkConnector) if needed.

General Changes

• All JViews products have improved globalization support for messages and resources, including better translatability support on editor tools. The JViews Web technologies improvements include client-dependent locale support.
• The license management mechanism has been replaced by a mechanism to declare the used feature set. Before you can use a certain feature, such as Maps or Gantt, your application must enable that feature once by using the API of ilog.views.util.IlvProductUtil. An additional keys.jlm license file is no longer required. Before deployment, use of jlmdeploy is no longer required. The jlmdeploy tool has been removed.
• Circular layout now supports the automatic clustering of a graph. It can be applied to a graph that has no cluster information. The clusters are created by analyzing the topology of the graph, and the nodes are ordered within each cluster to minimize link crossings.
• Hierarchical layout has a better layout of self links (links that start and end at the same node) and multilinks (bundles of links between the same pair of nodes).
• Swimlane constraints in hierarchical layout can have different margins at each side.
• Tree layout now supports a new balloon mode that is similar to the radial mode, but each subtree has its own circle center.
• Tree layout now supports multiple alternating circles in radial mode. It also can detect the optimal number of circles to minimize the space used by the layout.
• Uniform Length Edges layout now has better performance in FAST_MULTILEVEL_MODE layout mode. Also, customization APIs have been added for tuning the tradeoff between speed and quality in FAST_MULTILEVEL_MODE layout mode.

• The Hitmap technology allows high-responsive client-side interactions:
  • Graphic objects can be highlighted in browsers without a roundtrip to the server.
  • Tool tips can be shown when hovering graphic objects. This a new implementation of the tool tips that can work simultanously with other interactors such as the zoom and the pan interactors. To preserve the compatibility with previous releases, the imagemap-based tool tip implementation is still maintained. However, hitmap-based tool tips are preferable when implementing new JViews Web applications.
• A new interactor group component allows the combination of several interactors that are all active and work together at the same time. For example, you can combine the tool tip interactor, the highlight interactor, and the zoom interactor.
• Progressive zoom effect has been added. The progressive zoom is inactive by default to maintain compatibilities. It can be made active through the API.
• Scroll bars can be enabled for jvdf:diagrammerView.
• Selected nodes can be resized thanks to the selection improvement.
• Selected links can be edited thanks to the new link interactor.

Library Changes

New Interfaces and Classes

ilog.views.diagrammer.faces.dhtml.interactor.IlvFacesDiagrammerLinkInteractor

The IlvFacesDiagrammerLinkInteractor is the interactor used to modify JViews Diagrammer links. This interactor depends on the select interactor.

ilog.views.diagrammer.faces.dhtml.interactor.IlvFacesDiagrammerResizeInteractor

The IlvFacesDiagrammerResizeInteractor is the class for the JViews Faces resize interactor components.

ilog.views.diagrammer.faces.dhtml.renderkit.IlvFacesDiagrammerLinkInteractorRenderer

The IlvFacesDiagrammerLinkInteractorRenderer is a renderer for a move link interactor.

ilog.views.diagrammer.faces.dhtml.renderkit.IlvFacesDiagrammerResizeInteractorRenderer

The IlvFacesResizeInteractorRenderer is the resize interactor renderer.

ilog.views.diagrammer.faces.dhtml.taglib.IlvFacesDiagrammerLinkInteractorTag

This class defines the custom tag handler for a move link interactor.

ilog.views.diagrammer.faces.dhtml.taglib.IlvFacesDiagrammerResizeInteractorTag

This class defines the custom tag handler for the IlvFacesResizeInteractor component.

ilog.views.diagrammer.servlet.IlvDiagrammerLinkActionListener

IlvDiagrammerLinkActionListener defines a server action to support the reshaping of the selected link when requested by the client.

ilog.views.diagrammer.servlet.IlvDiagrammerResizeActionListener

IlvDiagrammerResizeActionListener defines a server action to resize the current selection.

ilog.views.sdm.renderer.IlvCachedLinkConnectionRectIndex

An object that knows about the link connection rectangle index of composite graphics.

ilog.views.sdm.renderer.graphlayout.IlvGraphLayoutEditor

Property editor for graph layouts.

Modified Classes

ilog.views.dashboard.IlvDashboardAction

• New fields:
  • linkIntermediatePointsAllowed: This action allows or not link intermediate points to be inserted when a link is created.

ilog.views.diagrammer.servlet.IlvDiagrammerSelectionSupport

• New methods:
  • addSelectedLink(IlvGraphic): Adds the IlvGraphic object to the selected link list.
  • clearSelectedLink(IlvGraphic): Clears the selected link list.
  • getSelectedLink(): Gets the link that is selected.
  • isResizable(IlvSelectionSupport.IlvSelectionResponse, Object): Checks whether the selected object is resizable or not.

ilog.views.graphlayout.circular.IlvCircularLayout

• Overview of new features:
  • Circular layout now supports the automatic clustering of a graph. It can be applied to a graph that has no cluster information. The clusters are created by analyzing the topology of the graph, and the nodes are ordered within each cluster to minimize link crossings.
• New methods:
  • customizeLayoutOfClusterGraph(IlvGraphLayout): Customizes the layout of the cluster graph before it is applied. This protected method is designed to be overridden. Used in clustering mode AUTOMATIC.
  • getHighDegreeStarClusterSize(): Returns the minimum size to create star clusters from nodes with high degree. Used in clustering mode AUTOMATIC.
  • setHighDegreeStarClusterSize(int): Sets the minimum size to create star clusters from nodes with high degree. Used in clustering mode AUTOMATIC.
  • getInterClusterLinkCrossingPenalty(): Returns the penalty for the crossing of links between nodes of different clusters. Used in clustering mode AUTOMATIC.
  • setInterClusterLinkCrossingPenalty(float): Sets the penalty for the crossing of links between nodes of different clusters. Used in clustering mode AUTOMATIC.
  • getIntraClusterLinkCrossingPenalty(): Returns the penalty for the crossing of links between nodes of the same cluster. Used in clustering mode AUTOMATIC.
  • setIntraClusterLinkCrossingPenalty(float): Sets the penalty for the crossing of links between nodes of the same cluster. Used in clustering mode AUTOMATIC.
  • getLayoutOfClusterGraph(): Returns the layout instance that lays out the graph of clusters. Used in clustering mode AUTOMATIC.
  • setLayoutOfClusterGraph(IlvGraphLayout): Sets the layout instance that lays out the graph of clusters. Used in clustering mode AUTOMATIC.
  • getMaximumClusterSize(): Returns the maximum number of nodes to form a cluster. Used in clustering mode AUTOMATIC.
  • setMaximumClusterSize(int): Sets the maximum number of nodes to form a cluster. Used in clustering mode AUTOMATIC.
  • getMaximumNumberOfIterationsToReachMaxClusterSize(): Returns the number of iterations to achieve the maximum cluster size. Used in clustering mode AUTOMATIC.
  • setMaximumNumberOfIterationsToReachMaxClusterSize(int): Sets the number of iterations to achieve the maximum cluster size. Used in clustering mode AUTOMATIC.
  • getMinimumClusterSize(): Returns the minimum number of nodes to form a cluster. Used in clustering mode AUTOMATIC.
  • setMinimumClusterSize(int): Sets the minimum number of nodes to form a cluster. Used in clustering mode AUTOMATIC.
  • getMixedClusterLinkCrossingPenalty(): Returns the penalty for the crossing of intra-cluster links with inter-cluster links. Used in clustering mode AUTOMATIC.
  • setMixedClusterLinkCrossingPenalty(float): Sets the penalty for the crossing of intra-cluster links with inter-cluster links. Used in clustering mode AUTOMATIC.
  • isClusterByBiconnectivity(): Returns whether the clustering by biconnectivity is enabled. Used in clustering mode AUTOMATIC.
  • setClusterByBiconnectivity(boolean): Sets whether the clustering by biconnectivity is enabled. Used in clustering mode AUTOMATIC.
  • isInterClusterCrossingReduction(): Returns whether the crossing reduction takes inter-cluster links into account. Used in clustering mode AUTOMATIC.
  • setInterClusterCrossingReduction(boolean): Sets whether the crossing reduction takes inter-cluster links into account. Used in clustering mode AUTOMATIC.


• New fields:
  • AUTOMATIC: Automatic clustering mode.

ilog.views.graphlayout.hierarchical.IlvHierarchicalLayout

• Overview of new features:
  • A better layout of self loops (links that start and end at the same node) has been added. Self loops are always routed orthogonally. Options have been added to choose at which side or corner the self loops are displayed.
  • A heuristic that avoids overlaps of multilinks (bundles of links between the same pair of nodes) has been added.
  • Time-consuming link optimizations can now be switched off.
• New methods:
  • getMultiLinkOptimizationMaxSpread(): Returns the maximum spread width for the bends introduced by the optimization of overlapping multiple links.
  • setMultiLinkOptimizationMaxSpread(float): Sets the maximum spread width for the bends introduced by the optimization of overlapping multiple links.
  • getMultiLinkOptimizationOffset(): Returns the minimum distance between bends introduced by the optimization of overlapping multiple links.
  • setMultiLinkOptimizationOffset(float): Sets the minimum distance between bends introduced by the optimization of overlapping multiple links.
  • getSelfLinkFromPortSide(): Returns the default port side of a self link at the "from" side.
  • setSelfLinkFromPortSide(int): Sets the default port side of a self link at the "from" side.
  • getSelfLinkToPortSide(): Returns the default port side of a self link at the "to" side.
  • setSelfLinkToPortSide(int): Sets the default port side of a self link at the "to" side.
  • isMultiLinkOptimizationEnabled(): Returns true if the optimization of overlapping multiple links is enabled.
  • setMultiLinkOptimizationEnabled(boolean): Sets whether the optimization of overlapping multiple links is enabled.
  • isNonorthogonalBendEliminationEnabled(): Returns true if the bend elimination phase for nonorthogonal links is enabled.
  • setNonorthogonalBendEliminationEnabled(boolean): Sets whether the bend elimination phase for nonorthogonal links is enabled.
  • isOrthogonalStairCaseEliminationEnabled(): Returns true if the stair case elimination phase for orthogonal links is enabled.
  • setOrthogonalStairCaseEliminationEnabled(boolean): Sets whether the stair case elimination phase for orthogonal links is enabled.
  • isSelfLinksSameSideNested(): Returns true if self links that attach the same side of a node are nested.
  • setSelfLinksSameSideNested(boolean): Sets whether self links that attach the same side of a node are nested.

ilog.views.graphlayout.hierarchical.IlvSwimLaneConstraint

• Overview of new features:
  • Swimlane constraints in hierarchical layout can have different margins at each side.
• New constructors:
  • IlvSwimLaneConstraint(IlvNodeGroup, float, int, float, float): Creates a new IlvSwimLaneConstraint .


• New methods:
  • getEastMinMargin(): Returns the specified minimal margin of the swimlane at the east side.
  • setEastMinMargin(float): Sets the minimal margin of the swimlane at the east side.
  • getWestMinMargin(): Returns the specified minimal margin of the swimlane at the west side.
  • setWestMinMargin(float): Sets the minimal margin of the swimlane at the west side.

ilog.views.graphlayout.tree.IlvTreeLayout

• Overview of new features:
  • Tree layout now supports a new balloon mode that is similar to the radial mode, but each subtree has its own circle center.
  • It is now possible to specify multiple alternating circles in radial mode. It also can detect the optimal number of circles that minimizes the space used by the layout.
• New methods:
  • getBalloonAngleSpacing(): Returns the current angle spacing for balloon layout mode.
  • setBalloonAngleSpacing(int): Sets the current angle spacing for balloon layout mode.
  • getBalloonInnerChildrenAngle(): Returns the maximum angle for children of inner nodes in balloon mode.
  • setBalloonInnerChildrenAngle(int): Sets the maximum angle for children of inner nodes in balloon mode.
  • getBalloonLeafChildrenAngle(): Returns the maximum angle for children of nodes that have only leaves as children in balloon mode.
  • setBalloonLeafChildrenAngle(int): Sets the maximum angle for children of nodes that have only leaves as children in balloon mode.
  • getBalloonRadiusMode(): Returns the radius mode for balloon layout mode.
  • setBalloonRadiusMode(int): Sets the current radius mode for balloon layout mode.
  • getBalloonRootChildrenAngle(): Returns the maximum angle for children of the root node in balloon mode.
  • setBalloonRootChildrenAngle(int): Sets the maximum angle for children of the root node in balloon mode.
  • getBalloonStartAngle(): Returns the start angle of the layout in balloon mode.
  • setBalloonStartAngle(int): Sets the start angle of the layout in balloon mode.
  • getNodeComparator(): Returns the comparator used for sorting the nodes.
  • setNodeComparator(Comparator): Sets the comparator used for sorting the nodes.
  • getNumberOfAlternatingCircles(): Returns the number of alternating circles.
  • setNumberOfAlternatingCircles(int): Sets the number of alternating circles.
  • isCategorizingLinksWithoutLayout(): Returns true if the layout algorithm does not perform a full layout.
  • setCategorizingLinksWithoutLayout(boolean): Sets whether the layout algorithm does not perform a full layout.


• New fields:
  • BALLOON: Balloon layout mode.
  • FAST_PROPORTIONAL: Fast proportional angle spacing of the balloon layout mode.
  • OPTIMIZED_UNIFORM_LEAVES_RADIUS: Optimized uniform balloon radius mode.
  • OPTIMIZED_VARIABLE_RADIUS: Optimized variable balloon radius mode.
  • PROPORTIONAL: Slow proportional angle spacing of the balloon layout mode.
  • REGULAR: Regular angle spacing of the balloon layout mode.
  • UNIFORM_LEAVES_RADIUS: Uniform leaves radius mode of the balloon layout mode.
  • UNIFORM_RADIUS: Uniform radius mode of the balloon layout mode.
  • VARIABLE_RADIUS: Variable balloon radius mode.

ilog.views.graphlayout.uniformlengthedges.IlvUniformLengthEdgesLayout

• Overview of new features:
  • The FAST_MULTILEVEL_MODE layout mode now has better performance.
  • Customization APIs have been added for tuning the tradeoff between speed and quality in FAST_MULTILEVEL_MODE layout mode.
• New methods:
  • getMaxPercentageOfElapsedTimeForRefinement(): Returns the maximum percentage of the time already elapsed to be spent on the final refinement step when the layout mode is FAST_MULTILEVEL_MODE.
  • setMaxPercentageOfElapsedTimeForRefinement(float): Sets the maximum percentage of the time already elapsed to be spent on the final refinement step when the layout mode is FAST_MULTILEVEL_MODE.
  • getMaxPercentageOfTotalAllowedTimeForRefinement(): Returns the upper limit for the duration of the fine-tuning step in FAST_MULTILEVEL_MODE layout mode as percentage of the total allowed time.
  • setMaxPercentageOfTotalAllowedTimeForRefinement(float): Sets the maximum percentage of the total allowed time to be spent on the final refinement step when the layout mode is FAST_MULTILEVEL_MODE.
  • getMaxRepeatForConvergence(): Returns the maximum number of attempts to reach convergence at each step when the layout mode is FAST_MULTILEVEL_MODE.
  • setMaxRepeatForConvergence(int): Sets the maximum number of attempts to reach convergence at each step when the layout mode is FAST_MULTILEVEL_MODE.

ilog.views.sdm.IlvSDMEngine

• New methods:
  • isEmptySubgraphAllowed(): Returns true if empty subgraphs are allowed.
  • setEmptySubgraphAllowed(boolean): Allows or not empty subgraphs.

ilog.views.sdm.graphic.IlvDefaultManagerFrameGraphic

• New constructors:
  • IlvDefaultManagerFrameGraphic(IlvDefaultManagerFrame): Creates a new IlvDefaultManagerFrameGraphic.

ilog.views.sdm.graphic.IlvURLGraphic

• New methods:
  • flush(String): Flushes the URL cache that corresponds to the input URL.

ilog.views.sdm.renderer.IlvSDMLinkConnector

• New methods:
  • setCachedLinkConnectionRectIndex(int): Caches the link connection rectangle index.
  • getCachedLinkConnectionRectIndex(): Returns the cached link connection rectangle index.

ilog.views.sdm.renderer.IlvSDMClippingLinkConnector

• New methods:
  • setCachedLinkConnectionRectIndex(int): Caches the link connection rectangle index.
  • getCachedLinkConnectionRectIndex(): Returns the cached link connection rectangle index.

ilog.views.sdm.renderer.IlvSDMFreeLinkConnector

• New methods:
  • useCache(): Returns true because this link connector uses the cache.
  • setCachedLinkConnectionRectIndex(int): Caches the link connection rectangle index.
  • getCachedLinkConnectionRectIndex(): Returns the cached link connection rectangle index.

ilog.views.sdm.renderer.IlvSDMRenderer

• Overview of new features:
  • The method getLinkConnectionRectangle(IlvSDMEngine, IlvGraphic, IlvTransformer) should no longer be overridden. Instead, override the new method below.
• New methods:
  • getLinkConnectionRectangle(IlvSDMEngine, IlvGraphic, IlvTransformer, IlvLinkConnector): Returns a rectangle on which the connection points of the links to/from a node should be located. This method can be overridden.

ilog.views.sdm.renderer.graphlayout.IlvGraphLayoutRenderer

• New methods:
  • getLinkConnectorMode(): Returns the link connector mode.
  • setLinkConnectorMode(int): Sets the link connector mode.

ilog.views.sdm.renderer.maps.IlvMapRenderer

• Overview of new features:
  • New methods have been introduced to allow control on the diagram behavior when some nodes have invalid coordinates, or coordinates not tolerated by the projection. It is now possible to indicate that such nodes are created anyway on the diagram, but are hidden.
• New methods:
  • createLinkGraphic(IlvSDMEngine, Object, IlvGraphic, IlvGraphic): This method has been overridden to hide the link if one of its extremities has invalid coordinates.
  • createNodeGraphic(IlvSDMEngine, Object): This method has been overridden to hide the graphic object if it has invalid coordinates.
  • isHideInvalidNodesAndLinks(): Indicates whether or not nodes that are not within the limits tolerated by the map projection are hidden.
  • setHideInvalidNodesAndLinks(boolean): Indicates whether or not nodes that are not within the limits tolerated by the map projection are hidden.

New JSF Components

jvdf:resizeInteractor

Supports resizing selected nodes in a diagram view.

jvdf:linkInteractor

Supports editing selected links in a diagram view.

Modified JSF Components

jvdf:diagrammerView

• New attributes:
  • progressiveZoom: Enables or disables the progressive zoom effect of the view.
  • scrollBars: Enables or disables scroll bars of the view.

New JavaScript Classes

IlvResizeInteractorProxy

JavaScript implementation for jvdf:resizeInteractor.

IlvLinkInteractorProxy

JavaScript implementation for jvdf:linkInteractor.

Example Changes

• jsf-diagrammer-oah: Integration of JViews Diagrammer JSF components with OpenAjax Hub 2.0.