This section presents the JTGO features impacted by compatibility issues:
Services
Deployment Descriptor
The deployment descriptor file is now validated when read to initialize an application context. This validation is accomplished by checking the contents of the deployment descriptor against the schema provided in data/ilog/cpl/schema/deploy.xsd.
In your deployment descriptor files, you must replace the first line:
<deployment>
by
<?xml version="1.0"?>
<deployment xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation = "ilog/cpl/schema/deploy.xsd">
Network Component
Layer Policy
The layer policy base class, ilog.tgo.graphic.IltLayerPolicy, has now two new methods:
-
attach (IltcCompositeManager): This method must be implemented to perform any initialization required by the layer policy implementation, for example, to create new layers in the associated grapher.
-
detach (IltcCompositeManager): This method must be implemented to clean up the composite grapher from any initialization performed by the layer policy implementation. This method is called when the layer policy is replaced by a new layer policy implementation.
The default layer policy implementation provided by ilog.tgo.graphic.IltCompositeGrapher.LayerPolicy has been changed to implement the methods attach and detach. The layer initialization has been moved from the class constructor to the method attach. If you have subclasses of this class, modify them to perform any layer initialization or any access to layers created by the superclass in the method attach instead of the class constructor. Also make sure that the layers added by your implementation are properly removed by implementing the method detach.
Business Objects
Alarm State Representation
-
The color used to represent alarms of severity
Impact.MajorLow has been changed from Red to Orange. To use the previous color, customize the following settings as illustrated below:
IltSettings.SetValue("Alarm.Impact.MajorLow.Color", Color.Red);
IltSettings.SetValue("Alarm.Impact.MajorLow.BrightColor", new Color(255,130,130));
IltSettings.SetValue("Alarm.Impact.MajorLow.DarkColor", new Color(175,0,0));
-
The short description used to represent impact alarms has been changed. The alarm count representation for impact alarms now uses the short description and an icon to represent the highest new or outstanding alarm severity. To use the previous alarm count representation, customize the following settings as illustrated below:
IltSettings.SetValue("Alarm.Impact.CriticalHigh.Abbreviation", "C!!");
IltSettings.SetValue("Alarm.Impact.CriticalLow.Abbreviation", "C!");
IltSettings.SetValue("Alarm.Impact.MajorHigh.Abbreviation", "M!!");
IltSettings.SetValue("Alarm.Impact.MajorLow.Abbreviation", "C!");
IltSettings.SetValue("Alarm.Impact.MinorHigh.Abbreviation", "m!!");
IltSettings.SetValue("Alarm.Impact.MinorLow.Abbreviation", "m!");
IltSettings.SetValue("Alarm.Impact.WarningHigh.Abbreviation", "w!!");
IltSettings.SetValue("Alarm.Impact.WarningLow.Abbreviation", "w!");
IltSettings.SetValue("Alarm.Impact.Unknown.Abbreviation", "u!");
IltSettings.SetValue("Alarm.Impact.CriticalHigh.Icon", null);
IltSettings.SetValue("Alarm.Impact.CriticalLow.Icon", null);
IltSettings.SetValue("Alarm.Impact.MajorHigh.Icon", null);
IltSettings.SetValue("Alarm.Impact.MajorLow.Icon", null);
IltSettings.SetValue("Alarm.Impact.MinorHigh.Icon", null);
IltSettings.SetValue("Alarm.Impact.MinorLow.Icon", null);
IltSettings.SetValue("Alarm.Impact.WarningHigh.Icon", null);
IltSettings.SetValue("Alarm.Impact.WarningLow.Icon", null);
IltSettings.SetValue("Alarm.Impact.Unknown.Icon", null);
-
The tooltip displayed for alarm counts has been changed and now uses the description of the alarm severity instead of the alarm severity abbreviation. To use the previous tooltip representation, customize the objects using CSS as follows:
object."ilog.tgo.model.IltObject/newAlarmCount" {
toolTipText: '@|newAlarmSummary("Default", "Abbreviation")';
object."ilog.tgo.model.IltObject/alarmCount" {
toolTipText: '@|alarmSummary("Default", "Abbreviation")';
object."ilog.tgo.model.IltObject/newImpactAlarmCount" {
toolTipText: '@|newAlarmSummary("Impact", "Abbreviation")';
object."ilog.tgo.model.IltObject/impactAlarmCount" {
toolTipText: '@|alarmSummary("Impact", "Abbreviation")';
-
The alarm summary information that can be displayed in the object information window now uses the alarm severity description instead of the alarm severity abbreviation. To use the previous summary representation, customize the objects using CSS as follows:
object."ilog.tgo.model.IltObject" {
listAlarmStateAbbreviated: true;
Web Components
The JTGO Web Components have been repackaged in a separate module within the JTGO installation: the jtgo-webc directory. This change may affect some users in the following ways:
-
The
jviews-webc12 directory
This directory has been removed from the JTGO installation. All resources and classes contained in this directory have been moved to the
jtgo-webc directory.
-
jviews-web-components.jar and web-components.jar
These .jar files have been moved to
jviews-webc.jar and
webc.jar respectively.
-
Contents of
jtgoall.jar
The
jtgoall.jar does not contain any of the web components classes and resources anymore, which are now packaged into a new jar file:
jtgo-webc.jar.
-
Web samples
The JTGO Web Components samples are now available in the
jtgo-webc directory.
As a consequence of this change, the web applications based on the JTGO Web Components require the inclusion of a new jar file:
jtgo-webc.jar along with the
jtgo-all.jar.
Miscellaneous