JViews Gantt Release Notes

This document describes the main changes that have been made to JViews Gantt since version 8.0.

Incompatibilities
General Changes
Library Changes

New Interfaces and Classes

• ilog.views.gantt.action.IlvScrollToTimeIndicatorAction
• ilog.views.gantt.event.ActivityGraphicInteractorEvent
• ilog.views.gantt.event.ActivityGraphicInteractorListener
• ilog.views.gantt.event.ActivityGraphicReshapedEvent
• ilog.views.gantt.graphic.IlvActivityTileLayout.DefaultTilingPolicy
• ilog.views.gantt.graphic.IlvActivityTileLayout.GraphicBounds
• ilog.views.gantt.graphic.IlvActivityTileLayout.TilingPolicy
• ilog.views.gantt.graphic.IlvConstraintGraphicLayer
• ilog.views.gantt.graphic.IlvConstraintGraphicLayerPolicy
• ilog.views.gantt.graphic.IlvTimeIndicatorReshapeFeedback
• ilog.views.gantt.graphic.renderer.IlvBasicActivityLabelBeanInfo

Modified Classes

• ilog.views.gantt.IlvGanttConfiguration
• ilog.views.gantt.IlvHierarchyChart
• ilog.views.gantt.faces.dhtml.component.IlvFacesDHTMLGanttChartView
• ilog.views.gantt.faces.dhtml.component.IlvFacesDHTMLGanttSupport
• ilog.views.gantt.faces.dhtml.component.IlvFacesDHTMLScheduleChartView
• ilog.views.gantt.faces.dhtml.taglib.IlvFacesDHTMLHierarchyChartViewTag
• ilog.views.gantt.graphic.IlvActivityGraphic
• ilog.views.gantt.graphic.IlvActivityTileLayout
• ilog.views.gantt.graphic.IlvGanttSheet
• ilog.views.gantt.graphic.IlvTimeIndicator
• ilog.views.gantt.graphic.interactor.IlvActivityGraphicReshapeInteractor
• ilog.views.gantt.graphic.renderer.IlvActivityCompositeRenderer
• ilog.views.gantt.graphic.renderer.IlvActivityGraphicRenderer
• ilog.views.gantt.graphic.renderer.IlvActivityRenderer
• ilog.views.gantt.graphic.timeindicator.IlvCurrentTimeIndicator
• ilog.views.gantt.graphic.timeindicator.IlvFixedTimeIndicator
• ilog.views.gantt.model.IlvSimpleActivity
• ilog.views.gantt.servlet.IlvGanttComponentSelectionSupport
• ilog.views.gantt.servlet.IlvGanttSelectionSupport
• ilog.views.gantt.servlet.IlvGanttSelectionSupport.IdentifierFactory
• ilog.views.gantt.servlet.IlvGanttServletSupport
• ilog.views.gantt.servlet.IlvGanttSheetSelectionSupport
• ilog.views.gantt.servlet.IlvGanttTableSelectionSupport
• ilog.views.gantt.swing.IlvTimeScrollBar
• ilog.views.gantt.xml.IlvGanttDocumentWriter
• ilog.views.gantt.xml.IlvSDXLConstants

Incompatibilities

• A new contains(IlvActivityGraphic, IlvPoint, IlvPoint, IlvTransformer) method has been added to the IlvActivityRenderer interface.
• A description parameter is now required to instantiate an IlvTimeIndicator or an IlvFixedTimeIndicator.
• The abort() method of the IlvActivityGraphicReshapeInteractor now takes a java.util.EventObject argument.
• The default size of the divider of IlvHierarchyChart is now taken from the current look and feel. Previously, the default size was 3.
• The IlvGanttSelectionSupport.IdentifierFactory interface contains new methods to implement.
• Capabilities requests on IlvGanttServletSupport now take "json" not "html" as format. Additional capabilities must now be streamed as JSON not JavaScript.

General Changes

• The Gantt Viewer is a major new sample that demonstrates a project viewer which integrates a PERT view developed with JViews Diagrammer.
• A new Vacation Activity sample has been added to demonstrate how to create user-defined activities.
• A new Composite Graphic code example has been added to show how to programatically create composite graphics-based activity renderers.
• Constraint graphics management within the Gantt sheet is now extensible. The Gantt Viewer uses this feature to put constraints belonging to the critical path above non-critical constraints in the z-order.
  • IlvConstraintGraphicLayer has been made public.
  • IlvConstraintGraphicLayerPolicy is a new class that encapsulates the constraint graphics management strategy.
  • New methods have been added to IlvGanttSheet for managing constraint layers and setting policies.
• Activity graphic hit testing has been made more accurate by delegating it to the IlvActivityRenderer. A new contains method has been added to the interface and has been implemented in all of the supplied renderer implementations:
• IlvActivityTileLayout now has a pluggable TilingPolicy that allows customization of how Gantt rows are divided into subrows and how activity graphics are assigned to the subrows. The default behaviour is implemented by IlvActivityTileLayout.DefaultTilingPolicy.
• Dates are now written into SDXL projects in a locale-aware manner.
• Time interval computation of parent IlvSimpleActivity can now be customized by overriding the new computeTimeIntervalFromChildren method.
• Listeners can now be registered with the IlvActivityGraphicReshapeInteractor to create visual feedback during reshape interactions.
  • ActivityGraphicInteractorListener, ActivityGraphicInteractorEvent and ActivityGraphicReshapedEvent have been added.
  • The IlvTimeIndicatorReshapeFeedback class displays a time indicator that follows the mouse as visual feedback.
• The ordering of resource data sets in an IlvResourceDataChart is now maintained to match the ordering of the resources in the Gantt data model.
• One-touch interaction of the Gantt divider has been enabled by default. This new interaction mode allows you to quickly expand or collapse the divider.
• Several improvements have been made to time indicators:
  • A description property has been added that is used for displaying tool tips.
    • A description is now required to instantiate an IlvTimeIndicator or an IlvFixedTimeIndicator.
    • IlvCurrentTimeIndicator is initialized with a default description.
  • IlvScrollToTimeIndicatorAction is a new action that scrolls to a given time indicator within a Gantt sheet.
  • The Time Indicator code example has been updated to demonstrate the new description property and the new IlvScrollToTimeIndicatorAction.
• IlvHierarchyChart now supports the concept of selectionAdjusting sessions.
• All resource bundles of JViews are now loaded through the IlvResourceUtil class. This class allows you to configure applets so that they no longer attempt to load resources unsuccessfully over the net for locale bundles that do not exist. This speeds up the startup time of applets that run in browsers with a different locale than the locales provided by the applet.
• BeanInfos have been provided for all of the Gantt renderers. This speeds up the styling of Gantt applets because the standard Introspector no longer attempts to search unsuccesfully for the BeanInfo over the net before creating it dynamically through reflection.
• The performance of CSS styling has been improved:
  •  Matching of the selectors has become more efficient when the style sheet has selectors with many different CSS types or with many different IDs.
  • Execution of the declarations has become more efficient when the same declarations apply to many different objects.
  • The evaluation of expressions in CSS declarations has been optimized.
  • The evaluation of constants as CSS declaration values has been optimized.

Library Changes

New Interfaces and Classes

ilog.views.gantt.action.IlvScrollToTimeIndicatorAction

The IlvScrollToTimeIndicatorAction class implements an action that will scroll to a specific IlvTimeIndicator for the specified IlvGanttSheet.

ilog.views.gantt.event.ActivityGraphicInteractorEvent

ActivityGraphicInteractorEvent is used to notify listeners when activity graphics are about to be, are currently being, or have just been modified by an interaction.

ilog.views.gantt.event.ActivityGraphicInteractorListener

ActivityGraphicInteractorListener is the listener interface for receiving events when interacting with activity graphics.

ilog.views.gantt.event.ActivityGraphicReshapedEvent

ActivityGraphicReshapedEvent is used to notify listeners when activity graphics are about to be, are currently being, or have just been reshaped by the IlvActivityGraphicReshapeInteractor.

ilog.views.gantt.graphic.IlvActivityTileLayout.DefaultTilingPolicy

A DefaultTilingPolicy takes each given activity graphic and attempts to place it into the first existing subrow that will accommodate it.

ilog.views.gantt.graphic.IlvActivityTileLayout.GraphicBounds

GraphicBounds is a structure that maintains an association between an activity graphic and its bounding box in the coordinates of the current view.

ilog.views.gantt.graphic.IlvActivityTileLayout.TilingPolicy

A TilingPolicy controls how many subrows are created for each Gantt row by the tile layout and how activities are assigned to the subrows.

ilog.views.gantt.graphic.IlvConstraintGraphicLayer

IlvConstraintGraphicLayer is a specific IlvManagerLayer for the management of constraint graphics.

ilog.views.gantt.graphic.IlvConstraintGraphicLayerPolicy

IlvConstraintGraphicLayerPolicy implements the default management of constraint graphics within the IlvGanttSheet.

ilog.views.gantt.graphic.IlvTimeIndicatorReshapeFeedback

IlvTimeIndicatorReshapeFeedback is used to display a time indicator during the reshape interaction, allowing you to see in a more detailed way the updated set date.

ilog.views.gantt.graphic.renderer.IlvBasicActivityLabelBeanInfo

Bean info for IlvBasicActivityLabel.

Modified Classes

ilog.views.gantt.IlvGanttConfiguration

• Overview of new features:
  • Support for selectionAdjusting sessions has been added.
• New methods:
  • isSelectionAdjusting(): Returns whether we are currently selecting or deselecting a series of objects.
  • setSelectionAdjusting(boolean): Starts a series of selection events.

ilog.views.gantt.IlvHierarchyChart

• Overview of new features:
  • Support for selectionAdjusting sessions has been added.
  • New "one-touch" interaction has been added to the Gantt splitter to quickly expand or collapse it.
• New methods:
  • getMinimumGanttSheetWidth(): Returns the minimum width of the Gantt sheet.
  • setMinimumGanttSheetWidth(int): Sets the minimum width of the Gantt sheet to a constant value.
  • getMinimumTableWidth(): Returns the minimum width of the table.
  • setMinimumTableWidth(int): Sets the minimum width of the table to a constant value.
  • isDividerOneTouchExpandable(): Returns whether the divider should provide a UI widget to quickly expand or collapse the divider.
  • setDividerOneTouchExpandable(boolean): Sets whether the divider should provide a UI widget to quickly expand or collapse the divider.
  • isSelectionAdjusting(): Returns whether we are currently selecting or deselecting a series of objects.
  • setSelectionAdjusting(boolean): Starts a series of selection events.

ilog.views.gantt.faces.dhtml.component.IlvFacesDHTMLGanttChartView

• New methods:
  • getBeforeSessionExpirationHandler(): Returns the JavaScript code that will be called when the session is about to expire.
  • setBeforeSessionExpirationHandler(String): Sets the JavaScript code that will be called when the session is about to expire.

ilog.views.gantt.faces.dhtml.component.IlvFacesDHTMLGanttSupport

• New methods:
  • getBeforeSessionExpirationHandler(): Returns the JavaScript code that will be called when the session is about to expire.
  • setBeforeSessionExpirationHandler(String): Sets the JavaScript code that will be called when the session is about to expire.

ilog.views.gantt.faces.dhtml.component.IlvFacesDHTMLScheduleChartView

• New methods:
  • getBeforeSessionExpirationHandler(): Returns the JavaScript code that will be called when the session is about to expire.
  • setBeforeSessionExpirationHandler(String): Sets the JavaScript code that will be called when the session is about to expire.

ilog.views.gantt.faces.dhtml.taglib.IlvFacesDHTMLHierarchyChartViewTag

• New methods:
  • getBeforeSessionExpirationHandler(): Returns the JavaScript code that will be called when the session is about to expire.
  • setBeforeSessionExpirationHandler(String): Sets the JavaScript code that will be called when the session is about to expire.

ilog.views.gantt.graphic.IlvActivityGraphic

• Overview of new features:
  • Hit testing is now computed in the activity graphic renderer and can be customized.
• New methods:
  • contains(IlvPoint, IlvPoint, IlvTransformer): Tests whether a point lies within the boundaries of the activity graphic.

ilog.views.gantt.graphic.IlvActivityTileLayout

• Overview of new features:
  • A new pluggable tiling policy allows customization of how Gantt rows are divided into subrows and how activity graphics are assigned to the subrows.
• New constructors:
  • IlvActivityTileLayout(IlvHierarchyChart, IlvActivityTileLayout.TilingPolicy, boolean, boolean): Creates a tile layout with the specified layout parameters.
  • IlvActivityTileLayout(IlvHierarchyChart, IlvActivityTileLayout.TilingPolicy, boolean, boolean, float, float, float): Creates a tile layout with the specified layout parameters.


• New methods:
  • getTilingPolicy(): Returns the tiling policy that controls how many subrows are created by the layout for each Gantt row and how activities are assigned to the subrows.
  • setTilingPolicy(IlvActivityTileLayout.TilingPolicy): Sets the tiling policy that controls how many subrows are created for each Gantt row and how activities are assigned to the subrows.

ilog.views.gantt.graphic.IlvGanttSheet

• Overview of new features:
  • The strategy by which constraints are added to and removed from the Gantt sheet is now customizable.
  • New pluggable interactor listeners allow you to add visual feedback on reshape interactions.
• New methods:
  • getConstraintGraphicLayerPolicy(): Returns the policy used to manage constraint graphics.
  • setConstraintGraphicLayerPolicy(IlvConstraintGraphicLayerPolicy): Sets the policy that is used to manage constraint graphics.
  • getDefaultConstraintGraphicLayerIndex(): Returns the index of the default layer that contains the constraint graphics.
  • getDefaultTimeIndicatorReshapeFeedback(): Returns the default time indicator reshape feedback.
  • isDefaultConstraintLayerVisible(): Returns whether the default constraint layer is visible.
  • setDefaultConstraintLayerVisible(boolean): Changes the visibility of the default constraint graphic layer.

ilog.views.gantt.graphic.IlvTimeIndicator

• Overview of new features:
  • A description property has been added that is now required when instantiating an IlvFixedTimeIndicator.
• New constructors:
  • IlvTimeIndicator(Date, IlvGraphic, String): Creates a new IlvTimeIndicator, for indicating a time, with an associated renderer.


• New methods:
  • getDescription(): Returns the description.
  • setDescription(String): Sets the description.
  • setToolTipText(String):
  • timeIndicatorBBox(): Returns the bounding rectangle of the time indicator renderer.

ilog.views.gantt.graphic.interactor.IlvActivityGraphicReshapeInteractor

• Overview of new features:
  • New pluggable interactor listeners allow you to add visual feedback on reshape interactions.
• New methods:
  • abort(EventObject): This function is called when the user presses the Esc key to abort the current interaction.
  • addActivityGraphicInteractorListener(IlvGanttSheet, ActivityGraphicInteractorListener): Adds the given listener subscribing for receiving reshape notifications.
  • removeActivityGraphicInteractorListener(IlvGanttSheet, ActivityGraphicInteractorListener): Removes the given listener.

ilog.views.gantt.graphic.renderer.IlvActivityCompositeRenderer

• Overview of new features:
  • Hit testing is now computed in the activity graphic renderer and can be customized.
• New methods:
  • contains(IlvActivityGraphic, IlvPoint, IlvPoint, IlvTransformer): This method is called by an activity graphic to test whether a point lies within its boundaries.

ilog.views.gantt.graphic.renderer.IlvActivityGraphicRenderer

• Overview of new features:
  • Hit testing is now computed in the activity graphic renderer and can be customized.
• New methods:
  • contains(IlvActivityGraphic, IlvPoint, IlvPoint, IlvTransformer): This method is called by an activity graphic to test whether a point lies within its boundaries.

ilog.views.gantt.graphic.renderer.IlvActivityRenderer

• Overview of new features:
  • Hit testing is now computed in the activity graphic renderer and can be customized.
• New methods:
  • contains(IlvActivityGraphic, IlvPoint, IlvPoint, IlvTransformer): This method is called by an activity graphic to test whether a point lies within its boundaries.

ilog.views.gantt.graphic.timeindicator.IlvCurrentTimeIndicator

• Overview of new features:
  • Added API for the IlvTimeIndicator description property.
• New methods:
  • getDefaultDescription(): Returns a default description for current time indicators.

ilog.views.gantt.graphic.timeindicator.IlvFixedTimeIndicator

• Overview of new features:
  • A description property has been added that is now required when instantiating an IlvFixedTimeIndicator.
• New constructors:
  • IlvFixedTimeIndicator(Date, String): Creates a new IlvFixedTimeIndicator, for a specific time using the default renderer.
  • IlvFixedTimeIndicator(Date, IlvGraphic, String): Creates a new IlvFixedTimeIndicator, for a specific time with the given renderer.

ilog.views.gantt.model.IlvSimpleActivity

• Overview of new features:
  • Time interval computation for parent activities can now be customized.
• New methods:
  • computeTimeIntervalFromChildren(): Calculates the time interval of this activity from its children.

ilog.views.gantt.servlet.IlvGanttComponentSelectionSupport

• New constructors:
  • IlvGanttComponentSelectionSupport(IlvGanttServletSupport): Creates a IlvGanttComponentSelectionSupport.


• New methods:
  • getSupport(): Returns the IlvGanttServletSupport instance attached to this support.

ilog.views.gantt.servlet.IlvGanttSelectionSupport

• New methods:
  • getObject(IlvGanttModel, String, String): Returns the Gantt model object corresponding to an identifier and a type.


• New fields:
  • ACTIVITY_OBJECT_TYPE: Identifier for the Gantt data model object type Activity.
  • CONSTRAINT_OBJECT_TYPE: Identifier for the Gantt data model object type Constraint.
  • RESERVATION_OBJECT_TYPE: Identifier for the Gantt model object type Reservation.
  • RESOURCE_OBJECT_TYPE: Identifier for the Gantt data model object type Resource.

ilog.views.gantt.servlet.IlvGanttSelectionSupport.IdentifierFactory

• New methods:
  • getActivityId(String): Returns the identifier of the activity associated with a reservation.
  • getFromActivityId(String): Returns the identifier of the fromActivity of a constraint.
  • getResourceId(String): Returns the identifier of the resource associated with a reservation.
  • getToActivityId(String): Returns the identifier of the toActivity of a constraint.

ilog.views.gantt.servlet.IlvGanttServletSupport

• Overview of new features:
  • Capabilities requests now take "json" not "html" as format. Additional capabilities must now be stream as JSON not JavaScript.
• New methods:
  • getAdditionalCapabilities(IlvHierarchyChart, IlvServletRequestParameters): Allows you to put additional capabilities to the capability request.


• New fields:
  • JSON_CAP_FORMAT: The JSON capabilities format value for CAP_FORMAT_PARAM.

ilog.views.gantt.servlet.IlvGanttSheetSelectionSupport

• New methods:
  • doGetDeselectAll(HttpServletRequest, IlvSelectionSupport.IlvSelectionResponse): Attempts to deselect all the objects that are currently selected.
  • doGetSelectAll(HttpServletRequest, IlvSelectionSupport.IlvSelectionResponse): Attempts to select all the selectable objects.
  • doGetSelectOneById(HttpServletRequest, IlvSelectionSupport.IlvSelectionResponse, String): Clears the current selections and attempts to select the object with the specified identifier.
  • doGetSelectOneMultipleById(HttpServletRequest, IlvSelectionSupport.IlvSelectionResponse, String): Attempts to extend the selection with the object with the specified identifier, if any.

ilog.views.gantt.servlet.IlvGanttTableSelectionSupport

• New methods:
  • doGetDeselectAll(HttpServletRequest, IlvSelectionSupport.IlvSelectionResponse): Attempts to deselect all the objects that are currently selected.
  • doGetSelectAll(HttpServletRequest, IlvSelectionSupport.IlvSelectionResponse): Attempts to select all the selectable objects.
  • doGetSelectOneById(HttpServletRequest, IlvSelectionSupport.IlvSelectionResponse, String): Clears the current selections and attempts to select the object with the specified identifier.
  • doGetSelectOneMultipleById(HttpServletRequest, IlvSelectionSupport.IlvSelectionResponse, String): Attempts to extend the selection with the object with the specified identifier, if any.

ilog.views.gantt.swing.IlvTimeScrollBar

• New methods:
  • setBounds(int, int, int, int): Moves and resizes the time scale.
  • widthChanged(int, int): This method is invoked when the time scrollbar width has been modified in bounded mode.

ilog.views.gantt.xml.IlvGanttDocumentWriter

• Overview of new features:
  • Dates are now written into SDXL projects in a locale-aware manner.
• New constructors:
  • IlvGanttDocumentWriter(Locale): Creates an IlvGanttDocumentWriter that uses an IlvGeneralActivityWriter, an IlvGeneralResourceWriter, an IlvGeneralConstraintWriter, and an IlvGeneralReservationWriter to write the activities, resources, constraints, and reservations, respectively.


• New methods:
  • getLocale(): Returns the locale used to convert dates to a textual representation.
  • setLocale(Locale): Sets the locale used to convert dates to a textual representation.

ilog.views.gantt.xml.IlvSDXLConstants

• Overview of new features:
  • Dates are now written into SDXL projects in a locale-aware manner.
• New fields:
  • LANGUAGE_ATTRIBUTE: The language attribute.

Example Changes

• Gantt Viewer: This major new sample presents a Gantt project viewer that integrates a PERT view developed with JViews Diagrammer.
• Vacation Activity: This new sample demonstrates creating user-defined activities.
• Composite Graphic: This new sample shows how to create composite graphics-based activity renderers programatically.
• Time Indicator: This code example has been updated to demonstrate the time indicator descriptions and the new IlvScrollToTimeIndicatorAction.