JViews TGO 8.7 Release Notes

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

Incompatibilities

General Changes

Library Changes
New Packages

• ilog.cpl.sdm
• ilog.cpl.sdm.binding

• ilog.cpl.sdm.IlpAbstractSDMAdapter
• ilog.cpl.sdm.IlpDefaultSDMAdapter
• ilog.cpl.sdm.binding.IlpAbstractAttributeBinding
• ilog.cpl.sdm.binding.IlpAbstractAttributeBinding.PropertyAlreadySetException
• ilog.cpl.sdm.binding.IlpAbstractAttributeBinding.ConversionFailedException
• ilog.cpl.sdm.binding.IlpAbstractPositionBinding
• ilog.cpl.sdm.binding.IlpAlarmSeverityColorBinding
• ilog.cpl.sdm.binding.IlpAttributeBindingContext
• ilog.cpl.sdm.binding.IlpDefaultAttributeBinding
• ilog.cpl.sdm.binding.IlpEnumBinding
• ilog.cpl.sdm.binding.IlpInvalidBindingException
• ilog.cpl.sdm.binding.IlpPointPositionBinding
• ilog.cpl.sdm.binding.IlpPolylinePositionBinding
• ilog.cpl.sdm.binding.IlpPolygonPositionBinding
• ilog.cpl.sdm.binding.IlpRectPositionBinding
• ilog.cpl.sdm.binding.IlpRelativePointPositionBinding
• ilog.cpl.sdm.binding.IlpShelfItemPositionBinding
• ilog.cpl.sdm.binding.IlpSlotSizesBinding

• ilog.cpl.datasource.IlpDefaultDataSource
• ilog.cpl.graphic.views.IlpSlotSizes
• ilog.cpl.interactor.IlpInteractor
• ilog.cpl.interactor.IlpAbstractInteractor
• ilog.cpl.interactor.IlpInteractionContext
• ilog.cpl.interactor.IlpDefaultInteractionContext
• ilog.tgo.faces.service.IltFacesDefaultContext
• ilog.tgo.faces.graph.dhtml.renderkit.IltFacesGraphViewRenderer

Modified JSF Components

• jvtf:networkView
• jvtf:equipmentView

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 are the ILOGKEYS.* files in the jars' META-INF directory.
• Interface IlpInteractor has been extended to include APIs to set and get actions based on a given gesture and modifier.
• Interface IlpInteractionContext has been extended to allow access to mouse modifiers.
• Method IlpAbstractInteractor.getGestureButton(IlpGesture) now returns the correct supported button values.
• Method IlpAbstractInteractor.manageSelection(IlpInteractorContext,IlpRepresentationObjectSelectionModel,IlpRepresentationObject) now takes the selectable CSS property into account.
• Deprecated class ilog.tgo.swing.IltComponentManager is no longer supported and can change in the future without notice.

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 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.
• A new adapter feature performs the dynamic conversion between a JViews TGO business data model (IlvSDMModel). This makes it possible to connect a JViews Diagrammer view with highly customizable symbols to a JViews TGO business data model. See the User's documentation and sample Converter for more details.

Library Changes

New Packages

ilog.cpl.sdm

This package contains the classes related to the new adapter feature that connects the JViews TGO business model and the JViews Diagrammer data model.

ilog.cpl.sdm.binding

This package contains the classes related to the binding between JViews TGO business object attributes (IlpAttribute) and JViews Diagrammer SDM properties.

New Interfaces and Classes

ilog.cpl.sdm.IlpAbstractSDMAdapter

This abstract class implements the adapter from a TGO business model (IlvSDMModel).

ilog.cpl.sdm.IlpDefaultSDMAdapter

This is the default implementation of the adapter between a mutable TGO data source (ilog.views.sdm.model.IlvBasicSDMModel).

ilog.cpl.sdm.binding.IlpAbstractAttributeBinding

This class defines a binding between a TGO attribute (IlpAttribute) of a given IlpClass and an SDM model property (IlvSDMModel).

ilog.cpl.sdm.binding.IlpAttributeBindingContext

This interface defines an API that provides the required runtime information used by bindings (IlpAbstractAttributeBinding) when converting SDM model properties to/from TGO attributes.

ilog.cpl.sdm.binding.IlpInvalidBindingException

This class defines an exception that is thrown when a binding is not permitted, usually because the adapter is already representing a data source.

ilog.cpl.sdm.binding.IlpAbstractAttributeBinding.PropertyAlreadySetException

This class represents an exception thrown when binding properties.

ilog.cpl.sdm.binding.IlpAbstractAttributeBinding.ConversionFailedException

This class represents an exception thrown when converting attribute and property values.

ilog.cpl.sdm.binding.IlpDefaultAttributeBinding

This class implements a default attribute binding that directly converts a TGO attribute of type Object to an SDM model property of the same type, with no type conversion in between.

ilog.cpl.sdm.binding.IlpAbstractPositionBinding

This class defines the base for TGO position attribute binding to SDM model properties x and y.

ilog.cpl.sdm.binding.IlpEnumBinding

This class defines a binding between a TGO attribute (IlpAttribute) of type IlEnum and an SDM model property of type String.

ilog.cpl.sdm.binding.IlpAlarmSeverityColorBinding

This class defines a binding intended to convert a TGO alarm severity attribute (IltObject.NewAlarmHighestSeverityAttribute, NewImpactAlarmHighestSeverityAttribute, AlarmHighestSeverityAttribute, ImpactAlarmHighestSeverityAttribute, AckAlarmHighestSeverityAttribute and AckImpactAlarmHighestSeverityAttribute) into an SDM model property representing the severity color.

ilog.cpl.sdm.binding.IlpPointPositionBinding

This class implements a default binding between a TGO position attribute of type IlpPoint and an SDM x or y model property of type Float.

ilog.cpl.sdm.binding.IlpPolylinePositionBinding

This class implements a default binding between a TGO position attribute of type IlpPolyPoints and an SDM x or y model property of type Float.

ilog.cpl.sdm.binding.IlpPolygonPositionBinding

This class implements a default binding between a TGO position attribute of type IlpPolygon and an SDM x or y model property of type Float.

ilog.cpl.sdm.binding.IlpRectPositionBinding

This class implements a default binding between a TGO position attribute of type IlpRect and an SDM x or y model property of type Float.

ilog.cpl.sdm.binding.IlpRelativePointPositionBinding

This class implements a default binding between a TGO position attribute of type IlpRelativePoint and an SDM x or y model property of type Float.

ilog.cpl.sdm.binding.IlpShelfItemPositionBinding

This class implements a default binding between a TGO position attribute of type IlpShelfItemPosition and an SDM x or y model property of type Float.

ilog.cpl.sdm.binding.IlpSlotSizesBinding

This class implements a default binding between a TGO slotSizes attribute of type IlpSlotSizes and an SDM slotWidth or slotHeight model property of type Integer.

Modified Classes

ilog.cpl.datasource.IlpDefaultDataSource

• Overview of new features:
  • Adds support for writing the data source content to a file using a given charset.
• New methods:
  • output(String, String, IlpFilter): Pretty-prints the data source content to a file.

ilog.cpl.graphic.views.IlpSlotSizes

• Overview of new features:
  • Adds methods to access the slot size width and height.
• New methods:
  • getHeightCount(): Method to access the number of slots across the height.
  • getWidthCount(): Method to access the number of slots across the width.

ilog.cpl.interactor.IlpInteractor

• Overview of new features:
  • Improves interaction customization by allowing actions to be associated with gestures and modifiers.
• New methods:
  • getGestureAction(IlpGesture, int): Returns the customized action associated with the given gesture and modifiers, if any.
  • setGestureAction(IlpGesture, int, Action): Associates an action with a specified gesture and modifier.

ilog.cpl.interactor.IlpAbstractInteractor

• Overview of new features:
  • Adds support for customizing how objects are selected.
• New methods:
  • isSelectable(IlpInteractionContext, IlpRepresentationObject): Identifies whether an object can be selected or not.

ilog.cpl.interactor.IlpInteractionContext

• Overview of new features:
  • Improves interaction customization by adding support to modifiersEx. This is needed as Java only provides accurate modifiersEx when the mouse button is pressed and JViews TGO processes mouse interactions only when the mouse button is released (thus the modifiersEx is no longer available through Java APIs).
• New methods:
  • getInitialModifiersEx(): Returns the modifiersEx of the event that started the interaction (usually java.awt.event.MouseEvent.MOUSE_PRESSED).
  • setInitialModifiersEx(int): Sets the modifiersEx of the event that started the interaction (usually java.awt.event.MouseEvent.MOUSE_PRESSED).

ilog.cpl.interactor.IlpDefaultInteractionContext

• Overview of new features:
  • Improves interaction customization by adding support to modifiersEx.
• New methods:
  • getInitialModifiersEx(): Returns the modifiersEx of the event that started the interaction.
  • setInitialModifiersEx(int): Sets the modifiersEx of the event that started the interaction.

ilog.tgo.faces.service.IltFacesDefaultContext

• Overview of new features:
  • Improves initialization support.
• New methods:
  • IltFacesDefaultContext(Locale, Object): Constructor allows any of the following Web contexts: FacesContext, PortletContext, and ServletContext.
  • setDefault(boolean): Sets the instance as the default JViews TGO context in the Web application. This method is particularly useful when declaring the context as a managed bean:

              <managed-bean>
                <managed-bean-name>defContext</managed-bean-name>
                <managed-bean-class>ilog.tgo.faces.service.IltFacesDefaultContext</managed-bean-class>
                <managed-bean-scope>session</managed-bean-scope>
                <managed-property>
                  <property-name>default</property-name>
                  <value>true</value>
                </managed-property>
              </managed-bean>
            

ilog.tgo.faces.graph.dhtml.renderkit.IltFacesGraphViewRenderer

• Overview of new features:
  • Improves Portlet support.
• New methods:
  • maybeSaveViewInSession(FacesContext, UIComponent): Stores the bound TGO Graph view instance in the session.

Modified JSF Components

jvtf:networkView

• New attributes:
  • scrollBars: Enables or disables scroll bars of the view.

jvtf:equipmentView

• New attributes:
  • scrollBars: Enables or disables scroll bars of the view.

Example Changes

• A new sample integration/converter has been created to illustrate the new feature that adapts a JViews TGO business data model to a JViews Diagrammer SDM model.