JViews Gantt 8.7 Release Notes

Release Notes

JViews Gantt 8.7 Release Notes

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

Incompatibilities
General Changes
Globalization: Locale Dependencies
Globalization: Right-to-Left Orientation
Customizable Representation of Lists of Resources
Performance Improvements
Other Changes in Gantt Classes
Thin-Client Resizing of Activities
Thin-Client Scroll Bars
Other API Changes in Web Technologies

Incompatibilities

The Clearthought TableLayout manager classes for Swing, in the info.clearthought.layout package, have been removed from the JViews Framework and are now supplied as an external library. These classes are required by the Designers, Map Builder, the Charts customizers, and the calendar Swing components.
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 are the ILOGKEYS.* files in the jars' META-INF directory.
The interface IlvGanttModel has two new methods setBatching(boolean) and isBatching(). If you have an implementation of this interface that is not a subclass of IlvAbstractGanttModel, you need to define these methods. A possible implementation (but that will not lead to performance improvements) is to define setBatching to a method that does nothing and isBatching to a method that returns false.
The method IlvJTree.rootRowVisibilityChanged no longer calls setShowRootHandles.

General Changes

The main general changes of JViews Gantt are the following:

The license management mechanism got replaced by a mechanism to declare the used feature set. Before you can use a certain feature such as Maps or Gantt, your application needs to enable that feature once by using the API of ilog.views.util.IlvProductUtil. An additional keys.jlm license file is no longer needed. Before deployment, use of jlmdeploy is no longer needed either. The jlmdeploy tool has been removed.
Modified Classes

ilog.views.util.IlvProductUtil
- New methods:
  - DeploymentLicenseRequired(String): This method allows you to declare which feature set, part of JViews, you are intending to use.
- New fields:
  - IBM_ILOG_JViews_Charts_Deployment: This object denotes all the features of JViews Charts.
  - IBM_ILOG_JViews_Diagrammer_Deployment: This object denotes all the features of JViews Diagrammer.
  - IBM_ILOG_JViews_Enterprise_Deployment: This object denotes all the features of JViews Enterprise.
  - IBM_ILOG_JViews_Gantt_Deployment: This object denotes all the features of JViews Gantt.
  - IBM_ILOG_JViews_Graph_Layout_for_Eclipse_Deployment: This object denotes all the features of JViews Graph Layout for Eclipse.
  - IBM_ILOG_JViews_Maps_Deployment: This object denotes all the features of JViews Maps.
  - IBM_ILOG_JViews_Maps_for_Defense_Deployment: This object denotes all the features of JViews Maps for Defense.
  - IBM_ILOG_JViews_TGO_Deployment: This object denotes all the features of JViews TGO.
New Interfaces and Classes

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Gantt_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Gantt.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Enterprise_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Enterprise.

The main general changes of JViews Web technologies are the following:

New interactor group component allowing combining several interactors that are all active and work together.
Gantt sheet supports horizontal and vertical scroll bars.
Selected activities can be resized thanks to the selection improvement.

Globalization: Locale Dependencies

In various classes that perform locale dependent processing, the locale can be specified explicitly.

Modified Classes

ilog.views.gantt.property.IlvFormattedTimeProperty

New constructors:
- IlvFormattedTimeProperty(Locale): Constructs a new IlvFormattedTimeProperty with a default DateFormat in the given locale.
- IlvFormattedTimeProperty(String, Locale): Constructs a new IlvFormattedTimeProperty with a SimpleDateFormat that uses the specified formatting string in the current locale.

New methods:
- setFormat(String, Locale): Sets the adapter formatter to be a date format that uses the specified SimpleDateFormat formatting string in the given locale.

ilog.views.schedule.text.IlvDateValueFormat

New constructors:
- IlvDateValueFormat(Locale): Creates a new IlvDataValueFormat will format dates values in short date and time style in the given locale.

ilog.views.util.text.IlvDateFormat

New constructors:
- IlvDateFormat(Locale): Creates a default date/time formatter that uses the SHORT style for both the date and the time in the given locale and the default timezone.

ilog.views.util.text.IlvDateFormatFactory

New methods:
- getInstance(Locale): Returns a default date/time formatter that uses the DateFormat.SHORT style for both the date and the time in the given locale and default timezone.

Globalization: Right-to-Left Orientation

The Gantt sheet and the time scales now support displaying from right-to-left. This is useful for languages with right-to-left text direction, such as Hebrew, Arabic, and Farsi.

Note: The Gantt component as a whole does not yet completely support right-to-left orientation.

Modified Classes

ilog.views.gantt.graphic.IlvGanttSheet

New methods:
- setComponentOrientation(ComponentOrientation): Sets the language-sensitive orientation of this time scale.

ilog.views.gantt.scale.IlvTimeScale

New methods:
- setComponentOrientation(ComponentOrientation): Sets the language-sensitive orientation of this time scale.

ilog.views.gantt.scale.IlvTimeScaleRow

New methods:
- getComponentOrientation(): Returns the language-sensitive orientation of this scale row.

ilog.views.gantt.IlvTimeScrollSupport

New methods:
- isLeftToRight(): Returns whether time increases left-to-right in the view.
- setLeftToRight(boolean): Sets whether time increases left-to-right in the view.

ilog.views.gantt.graphic.IlvActivityGraphic

New methods:
- isLeftToRight(): Returns whether time increases left-to-right in the Gantt sheet.

ilog.views.gantt.graphic.renderer.IlvBasicActivityLabel

New fields:
- INSIDE_LEADING: The box-orientation constant used to specify that the label is drawn inside the main activity renderer on the leading text edge.
- INSIDE_TRAILING: The box-orientation constant used to specify that the label is drawn inside the main activity renderer on the trailing text edge.

Customizable Representation of Lists of Resources

The display of multiple reservations for a single activity, as a string in a table cell, is now customizable.

Modified Classes

ilog.views.gantt.property.IlvActivityReservationsProperty

New methods:
- getListFormat(): Returns the list formatter used to format the list of resources for an activity.
- setListFormat(IlvListFormat): Sets the list formatter used to format the list of resources for an activity.
- getSortingCriterion(): Returns the sorting criterion for the reservations belonging to a single activity.
- setSortingCriterion(Comparator): Sets the sorting criterion for the reservations belonging to a single activity, as reported by getValue(Object).

New Interfaces and Classes

ilog.views.util.text.IlvListFormat

This class is the abstract base class for classes that format a list of items, producing a single string.

ilog.views.util.text.IlvSimpleListFormat

This class formats a list of items, producing a single string.

ilog.views.util.text.IlvPatternBasedListFormat

This class formats a list of items, producing a single string.

Updating a resource chart when many changes are being done to a Gantt model within a short period has become much faster. In order to benefit from this speedup, your application needs to call the method IlvGanttModel.setBatching before and after a batch of model changes.

Modified Classes

ilog.views.gantt.IlvGanttModel

New methods:
- isBatching(): Returns whether a batching session is currently active.
- setBatching(boolean): Starts or ends a batching session.

New fields:
- BATCHING_PROPERTY: Identifies that a batching session has begun or ended.

ilog.views.gantt.model.IlvAbstractGanttModel

New methods:
- isBatching(): Returns whether a batching session is currently active.
- setBatching(boolean): Starts or ends a batching session.

ilog.views.gantt.model.filter.IlvFilterGanttModel

New methods:
- isBatching(): Returns whether a batching session is currently active.
- setBatching(boolean): Starts or ends a batching session.

Other Changes in Gantt Classes

Modified Classes

ilog.views.gantt.IlvTimeScrollUtil

New methods:
- getX0(IlvTimeConverter, Date, int, int, double): Computes the offset used to transform an x position in world coordinates to its corresponding position in pixel display coordinates.

ilog.views.gantt.graphic.grid.IlvVerticalGanttGrid

New methods:
- getCalendar(Date): Returns a copy of the grid's calendar that points to the specified time.
- getDrawingInterval(Graphics, IlvGanttGridContext): Returns the time interval of the drawing rectangle.

ilog.views.gantt.xml.IlvGanttDocumentWriter

New methods:
- getPropertyEditor(Class): Returns the specified property editor for a type of properties.
- setPropertyEditor(Class, PropertyEditor): Specifies a property editor for a type of properties.

ilog.views.gantt.xml.IlvSDXLFileConnector

New constructors:
- IlvSDXLFileConnector(IlvGanttDocumentReader, IlvGanttDocumentWriter): Creates an IlvSDXLFileConnector with a specific customized XML document reader and a specific customized XML document writer.

ilog.views.gantt.scale.IlvTimeScale

New methods:
- getLocale(): Returns the locale of this scale.

ilog.views.gantt.scale.IlvTimeScaleRow

New methods:
- getLocale(): Returns the locale of this scale row.

Thin-Client Resizing of Activities

A new interactor has been added that allows the user to resize activities in a Gantt view or schedule view.

New JSF Components

jvgf:resizeActivityInteractor

Allows resizing selected activities in a Gantt view or a schedule view.

New Interfaces and Classes

ilog.views.gantt.faces.interactor.IlvFacesResizeActivityInteractor

This class defines an interactor that allows you to resize a selected activity when it is set on a sheet view of a Gantt view or a schedule chart view.

ilog.views.gantt.faces.dhtml.renderkit.IlvFacesResizeActivityInteractorRenderer

The IlvFacesResizeActivityInteractorRenderer is the resize activity interactor renderer.

ilog.views.gantt.faces.dhtml.taglib.IlvFacesResizeActivityInteractorTag

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

ilog.views.gantt.servlet.IlvResizeActivityAction

This action is used to resize a selected activity.

Modified Classes

ilog.views.gantt.faces.IlvFacesGanttConstants

New fields:
- RESIZE_ACTIVITY: The default action name of the resize activity interactor.

ilog.views.gantt.faces.dhtml.servlet.IlvFacesGanttServletSupport

New methods:
- getDefaultResizeActivityAction(): Returns the action taken when resizing activities.
- setDefaultResizeActivityAction(IlvServerAction): Sets the action taken when resizing activities.

Thin-Client Scroll Bars

The Gantt sheet now supports horizontal and vertical scroll bars also in thin-client.

Modified JSF Components

jvgf:ganttView

New attributes:
- sheetHScrollable: Enables or disables the horizontal scroll bar of the Gantt sheet.
- sheetVScrollable: Enables or disables the vertical scroll bar of the Gantt sheet.

jvgf:scheduleView

New attributes:
- sheetHScrollable: Enables or disables the horizontal scroll bar of the Gantt sheet.
- sheetVScrollable: Enables or disables the vertical scroll bar of the Gantt sheet.

Modified Classes

ilog.views.gantt.faces.IlvFacesGanttConstants

New fields:
- H_SHEET_SCROLLABLE: The hSheetScrollable of the ilog.views.gantt.faces.component.IlvFacesHierarchyChartView.
- V_SHEET_SCROLLABLE: The vSheetScrollable of the ilog.views.gantt.faces.component.IlvFacesHierarchyChartView.

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

New methods:
- getSheetHScrollable(): Gets sheetHScrollable attribute value of this tag.
- setSheetHScrollable(String): Sets the sheetHScrollable attribute value of this tag.
- getSheetVScrollable(): Gets sheetVScrollable attribute value of this tag.
- setSheetVScrollable(String): Sets the sheetVScrollable attribute value of this tag.

Modified JavaScript Classes

IlvGanttView

New methods:
- setSheetHScrollable(scrollable): Enables or disables the horizontal scroll bar of the Gantt sheet.
- setSheetVScrollable(scrollable): Enables or disables the vertical scroll bar of the Gantt sheet.

IlvHierarchyChartViewProxy

New methods:
- setSheetHScrollable(scrollable): Enables or disables the horizontal scroll bar of the Gantt sheet.
- setSheetVScrollable(scrollable): Enables or disables the vertical scroll bar of the Gantt sheet.

Other API Changes in Web Technologies

Modified Classes

ilog.views.gantt.servlet.IlvGanttServletSupport

New methods:
- getScriptMessageSupport(): Returns the script message support.