JViews Gantt Release Notes

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

Incompatibilities
General Changes
Library Changes
New Packages

• ilog.views.gantt.graphic.timeindicator

New Interfaces and Classes

• ilog.views.gantt.faces.dhtml.component.IlvFacesGanttPropertyAccessor
• ilog.views.gantt.faces.dhtml.component.IlvFacesGanttSelectionManager
• ilog.views.gantt.faces.dhtml.interactor.IlvFacesGanttSelectInteractor
• ilog.views.gantt.faces.dhtml.renderkit.IlvFacesGanttSelectInteractorRenderer
• ilog.views.gantt.faces.dhtml.renderkit.IlvFacesGanttSelectionManagerRenderer
• ilog.views.gantt.faces.dhtml.servlet.IlvFacesGanttSelectionSupport
• ilog.views.gantt.faces.dhtml.servlet.IlvFacesGanttSheetSelectionSupport
• ilog.views.gantt.faces.dhtml.servlet.IlvFacesGanttTableSelectionSupport
• ilog.views.gantt.faces.dhtml.taglib.IlvFacesGanttSelectInteractorTag
• ilog.views.gantt.faces.dhtml.taglib.IlvFacesGanttSelectionManagerTag
• ilog.views.gantt.graphic.IlvTimeIndicator
• ilog.views.gantt.graphic.timeindicator.IlvCurrentTimeIndicator
• ilog.views.gantt.graphic.timeindicator.IlvFixedTimeIndicator
• ilog.views.gantt.graphic.timeindicator.IlvTimeIndicatorContext
• ilog.views.gantt.property.IlvAbstractUserDefinedProperty
• ilog.views.gantt.property.IlvActivityUserDefinedProperty
• ilog.views.gantt.property.IlvResourceUserDefinedProperty
• ilog.views.gantt.servlet.IlvGanttComponentSelectionSupport
• ilog.views.gantt.servlet.IlvGanttSelectionSupport
• ilog.views.gantt.servlet.IlvGanttSheetSelectionSupport
• ilog.views.gantt.servlet.IlvGanttTableSelectionSupport
• ilog.views.gantt.swing.IlvConfigurableTableColumn

Modified Classes

• ilog.views.gantt.event.SelectionEvent
• ilog.views.gantt.faces.IlvFacesGanttConstants
• ilog.views.gantt.faces.component.IlvFacesHierarchyChartView
• ilog.views.gantt.faces.dhtml.taglib.IlvFacesDHTMLHierarchyChartViewTag
• ilog.views.gantt.graphic.IlvGanttSheet
• ilog.views.gantt.model.IlvAbstractGanttModel
• ilog.views.gantt.servlet.IlvGanttServletSupport
• ilog.views.gantt.servlet.ServerActionEvent
• ilog.views.gantt.swing.IlvJTable
• ilog.views.gantt.swing.calendarview.IlvDayView
• ilog.views.gantt.swing.calendarview.IlvHourlyActivitySheet

Incompatibilities

• Names, titles, and descriptive text of some examples were changed. Note, that example directories and code structure remains the same.
• IlvAbstractEventDispatcher has changed the naming of its protected field _listeners to listeners.
• A new layer has been added to the manager of IlvGanttSheet to draw an IlvTimeIndicator as part of the implementation of the new time indicators feature.
  • In JViews 5.5 and earlier, the numbering of the predefined layers was:
    • 0 : grids (horizontal and vertical)
    • 1 : activity graphics
    • 2 : constraint graphics
  • Starting, with JViews 6.0, the numbering of the predefined layers was:
    • 0 : horizontal grid
    • 1 : vertical grid
    • 2 : activity graphics
    • 3 : constraint graphics
  • The new numbering of the predefined layers is:
    • 0 : horizontal grid
    • 1 : vertical grid
    • 2 : activity graphics
    • 3 : constraint graphics
    • 4 : time indicators
  • The removeLayer() method of the IlvGanttSheet manager now throws an exception if the user attempts to remove one of the five predefined layers.

General Changes

• The Gantt selection event now supports multiple events:
  • setAdjusting/getAdjusting methods have been added to the SelectionEvent.
  • IlvGanttConfiguration has been modified to set the adjusting flag accordingly when processing selection from either the Gantt sheet or the table. The flag is set to true while performing multiple events and is set to false for the last event.
• The getNode method was added to IlvJTable. It allows you to obtain the IlvHierarchyNode (a row of the table) for a particular table index.
• Dynamic table columns have been implemented:
  • There are three new classes for creating property adapters for user-defined properties: IlvAbstractUserDefinedProperty, IlvActivityUserDefinedProperty and IlvResourceUserDefinedProperty.
  • Configurable table columns are implemented by the new IlvConfigurableTableColumn class.
• A clear method has been added to IlvAbstractGanttModel.
• The arrangement of milestones in IlvActivityTileLayout has been improved.
• A new time indicator feature has been added to the Gantt and Schedule charts:
  • Four new classes have been added within the new timeindicator package: IlvTimeIndicator, IlvFixedTimeIndicator, IlvCurrentTimeIndicator, and IlvTimeIndicatorContext.
  • New methods have been added to IlvGanttSheet for managing the time indicators and for supporting the new layer on which they are drawn.
• Lightweight selection and property editing mechanisms have been added to the Gantt JavaServer Faces components:
  • There is a new tag  to configure the selection: jvgf:selectionManager
  • There is a new tag  to set the interactor to select and move Gantt objects: jvgf:selectInteractor
  • There is a new server-side class, IlvFacesGanttPropertyAccessor, to customize the retrieval and setting of properties of selected objects.
• A new Search example has been added that demonstrates find/select capabilities within a Gantt chart.
• A new Benchmark example has been added that allows you to measure the time taken to load and create Gantt charts.
• A new JavaServer Faces Editing sample has been added that demonstrates the new selection mechanism and the editing of properties.
• Activity drag interactors have been added to the Calendar View demo

Library Changes

New Packages

ilog.views.gantt.graphic.timeindicator

This package contains the classes that render a time indicator in the Gantt sheet.

New Interfaces and Classes

ilog.views.gantt.faces.dhtml.component.IlvFacesGanttPropertyAccessor

The IlvFacesGanttPropertyAccessor class controls the access of the ilog.views.gantt.faces.dhtml.component.IlvFacesGanttSelectionManager to the properties of the selected objects for read or write operations and allows you to customize the handling of properties.

ilog.views.gantt.faces.dhtml.component.IlvFacesGanttSelectionManager

The IlvFacesGanttSelectionManager class allows you to configure the management and rendering of the lightweight selection.

ilog.views.gantt.faces.dhtml.interactor.IlvFacesGanttSelectInteractor

A Gantt specific implementation of IlvFacesSelectInteractor.

ilog.views.gantt.faces.dhtml.renderkit.IlvFacesGanttSelectInteractorRenderer

This class is the Gantt specific renderer for a IlvFacesSelectInteractor component.
This renderer generates an instance of the IlvGanttSelectInteractorProxy JavaScript proxy class.

ilog.views.gantt.faces.dhtml.renderkit.IlvFacesGanttSelectionManagerRenderer

This class is the renderer for an IlvFacesGanttSelectionManager component.

ilog.views.gantt.faces.dhtml.servlet.IlvFacesGanttSelectionSupport

This class is the IlvSelectionSupport implementation dedicated to the JavaServer Faces Gantt component.

ilog.views.gantt.faces.dhtml.servlet.IlvFacesGanttSheetSelectionSupport

This class is the IlvSelectionSupport implementation dedicated to the JavaServer Faces Gantt Sheet component.

ilog.views.gantt.faces.dhtml.servlet.IlvFacesGanttTableSelectionSupport

This class is the IlvSelectionSupport implementation dedicated to the JavaServer Faces Gantt Table component.

ilog.views.gantt.faces.dhtml.taglib.IlvFacesGanttSelectInteractorTag

This class defines the JSP custom tag handler for the IlvFacesGanttSelectInteractor component and its specific DHTML renderer.

ilog.views.gantt.faces.dhtml.taglib.IlvFacesGanttSelectionManagerTag

This class defines the JSP custom tag handler for the ilog.views.gantt.faces.dhtml.component.IlvFacesGanttSelectionManager component and its specific DHTML renderer.

ilog.views.gantt.graphic.IlvTimeIndicator

The IlvTimeIndicator class is used to represent a time in an IlvGanttSheet.

ilog.views.gantt.graphic.timeindicator.IlvCurrentTimeIndicator

The IlvCurrentTimeIndicator class is used to represent the current time in an ilog.views.gantt.graphic.IlvGanttSheet.

ilog.views.gantt.graphic.timeindicator.IlvFixedTimeIndicator

The IlvFixedTimeIndicator class is used to represent a specific time in an ilog.views.gantt.graphic.IlvGanttSheet.

ilog.views.gantt.graphic.timeindicator.IlvTimeIndicatorContext

The IlvTimeIndicatorContext class is used for painting the time indicators of the Gantt sheet on the screen.

ilog.views.gantt.property.IlvAbstractUserDefinedProperty

IlvAbstractUserDefinedProperty provides a common framework for accessing arbitrary user-defined properties of an IlvUserPropertyHolder through the generic IlvStringProperty interface.

ilog.views.gantt.property.IlvActivityUserDefinedProperty

IlvActivityUserDefinedProperty is an adapter that allows a user-defined property of an IlvGeneralActivity to be accessed through the generic IlvStringProperty interface.

ilog.views.gantt.property.IlvResourceUserDefinedProperty

IlvResourceUserDefinedProperty is an adapter that allows a user-defined property of an IlvGeneralResource to be accessed through the generic IlvStringProperty interface.

ilog.views.gantt.servlet.IlvGanttComponentSelectionSupport

Definition of shared selection support for Gantt chart components.

ilog.views.gantt.servlet.IlvGanttSelectionSupport

This class is the IlvSelectionSupport implementation dedicated to Gantt charts.

ilog.views.gantt.servlet.IlvGanttSheetSelectionSupport

This class is the IlvSelectionSupport implementation dedicated to the Gantt sheet diagram.

ilog.views.gantt.servlet.IlvGanttTableSelectionSupport

This class is the IlvSelectionSupport implementation dedicated to the Gantt table.

ilog.views.gantt.swing.IlvConfigurableTableColumn

IlvConfigurableTableColumn is a column definition that can be customized for rendering and editing a property of an IlvHierarchyNode, that is, an activity or a resource, in an IlvJTable.

Modified Classes

ilog.views.gantt.event.SelectionEvent

• Overview of new features:
  • Gantt selection event supports multiple events.
• New methods:
  • isAdjusting(): Returns the event adjusting value.
  • setAdjusting(boolean): Sets whether this event is multiple or not.

ilog.views.gantt.faces.IlvFacesGanttConstants

• Overview of new features:
  • Property editing in the JavaServer Faces Gantt component has been added.
• New fields:
  • EDITABLE: The editable state of the ilog.views.gantt.faces.component.IlvFacesHierarchyChartView
  • PROPERTY_ACCESSOR: The propertyAccessor property of the ilog.views.gantt.faces.dhtml.component.IlvFacesGanttSelectionManager.

ilog.views.gantt.faces.component.IlvFacesHierarchyChartView

• Overview of new features:
  • New editable property to control the ability to edit properties of Gantt model objects in the JavaServer Faces Gantt.
• New methods:
  • isEditable(): Returns whether or not the IlvFacesHierachyChartView is editable.
  • setEditable(boolean): Sets whether or not the IlvFacesHierachyChartView is editable.

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

• Overview of new features:
  • New editable attribute to control the ability to edit properties of Gantt model objects in the JavaServer Faces Gantt.
• New methods:
  • getEditable(): Returns whether or not the component is editable.
  • setEditable(String): Sets whether or not the component is editable.

ilog.views.gantt.graphic.IlvGanttSheet

• Overview of new features:
  • Support for time indicators in a separate layer has been added.
• New methods:
  • addTimeIndicator(IlvTimeIndicator): Adds a time indicator to the Gantt sheet.
  • createTimeIndicatorContext(): This function creates an IlvTimeIndicatorContext for the Gantt sheet.
  • getTimeIndicator(Date): Returns the time indicator graphic representing the specified date or the current date in the Gantt sheet.
  • getTimeIndicatorLayerIndex(): Returns the index of the layer that contains the time indicator graphics.
  • getTimeIndicators(): Returns a collection of all the time indicator graphics in the Gantt sheet.
  • isTimeIndicatorLayerVisible(): Returns whether the time indicator layer is visible.
  • setTimeIndicatorLayerVisible(boolean): Changes the visibility of the time indicator graphic layer.
  • removeTimeIndicator(IlvTimeIndicator): Removes a time indicator from the Gantt sheet.
  • replaceTimeIndicator(IlvTimeIndicator, IlvTimeIndicator, boolean): Replaces a time indicator graphic in the Gantt sheet with another one.
  • timeIndicatorsIterator(): Returns an iterator over all the time indicator graphics in the Gantt sheet.

ilog.views.gantt.model.IlvAbstractGanttModel

• New methods:
  • clear(): Removes all objects from the data model.

ilog.views.gantt.servlet.IlvGanttServletSupport

• Overview of new features:
  • Lightweight selection and property editing have been added to the JavaServer Faces Gantt.
• New methods:
  • createSelectionSupport(): Creates a new instance of selection servlet support.
  • getObjectAt(IlvServletRequestParameters, int, int): Returns the object at the specified location inside a component.
  • getSelectionSupport(): Returns the servlet support that manages selection requests.
  • isSelectionEnabled(): Returns true if the servlet is set to handle selection requests in the sheet area.
  • setSelectionEnabled(boolean): Enables or disables the support of selection requests in the sheet area.

ilog.views.gantt.servlet.ServerActionEvent

• Overview of new features:
  • Added the servlet support to the event for the new lightweight selection in JavaServer Faces Gantt.
• New constructors:
  • ServerActionEvent(HttpServletRequest, IlvHierarchyChart, String, IlvGanttServletSupport, String[]): Creates a new action event.


• New methods:
  • getServletSupport(): Returns the IlvGanttServletSupport that created the event.

ilog.views.gantt.swing.IlvJTable

• New methods:
  • getNode(int): Gets the row that is visible on the specified row index.

ilog.views.gantt.swing.calendarview.IlvDayView

• New methods:
  • getHourlyActivitySheet(): Returns the hourly activity sheet.

ilog.views.gantt.swing.calendarview.IlvHourlyActivitySheet

• New methods:
  • getCalendar(int): Returns the calendar that corresponds to the specified Y position.

Example Changes

• Searching Activities: This new sample shows how to implement find/select capabilities within a Gantt chart.
• Benchmark: This new sample allows you to measure the time taken to load and create Gantt charts.
• JSF Gantt Chart Editing: This new sample demonstrates editing capabilities within a JavaServer Faces Gantt chart.
• Calendar Views: This has been updated with activity drag interactors.