Alarm configuration properties

Properties for customizing the alarm configuration

CSS properties for the alarm configuration

Property Name	Type	Default Value	Description
`primaryAlarmState`	`IltAlarmStateEnum`	`Raw`	Determines whether the raw alarms or the impact alarms are displayed as the primary alarm state. Possible values are: `Raw` `Impact`
`alarmBorderVisible`	`boolean`	`true`	Indicates whether the alarm border is visible or not around the object base.
`alarmBorderColor`	`Color`	transparent ( `null` )	Defines the color used to represent the alarm border around the base.
`alarmBorderWidth`	`int`	2	Defines the width of the alarm border.
`alarmColorVisible`	`boolean`	true	Determines whether the alarm color is visible or not in the object value.
`alarmColor`	`Color`	transparent ( `null` )	Determines the color representing alarms in the object base. This property is only taken into account when property `alarmColorVisible` is set to `true` .
`alarmBrightColor`	`Color`	transparent ( `null` )	Determines the bright color representing alarms in the object base. This property is only taken into account when property `alarmColorVisible` is set to `true` .
`alarmDarkColor`	`Color`	transparent ( `null` )	Determines the dark color representing alarms in the object base. This property is only taken into account when property `alarmColorVisible` is set to `true` .
`alarmAsMark`	`boolean`	`false`	Defines whether the new alarm information is displayed using the alarm balloon or an alarm marker. The alarm marker is another type of balloon with a triangular format. It is displayed in the color of the new alarm highest severity, without the alarm count information.
`alarmLossOfConnectivityOverride`	`boolean`	`true`	Denotes whether the loss of connectivity alarm state overrides the highest alarm representation in the object base. If the object has the loss of connectivity state set and this property is set to `true` , the object base is displayed using the loss of connectivity colors. If this property is set to `false` , the object base is displayed as usual, and the loss of connectivity is represented using a secondary state icon.
`alarmLossOfConnectivityPosition`	`IltGraphicElementName`	`AlarmCount`	Defines the position of the loss of connectivity indicator when the loss of connectivity override property is set to `true` . Possible values are: `AlarmCount` : the indicator is the string specified by the `Alarm.LossOfConnectivity.Abbreviation` setting and is displayed as an alarm count. `SecondaryStateModifiers` : the indicator is the loss of connectivity icon. It is displayed as a secondary state and takes the loss of connectivity color .

How to customize the alarm representation for predefined business objects

The following CSS extract modifies the graphic representation of network element objects, so that raw alarms are considered as primary alarms. As such, they are represented in the object base, the alarm count and the alarm balloon using the default JViews TGO look and feel. In addition, the example modifies the object so that, when the Loss Of Connectivity alarm state is set, it is graphically represented as a secondary state icon and the object base color and object border color are not affected.

object."ilog.tgo.model.IltNetworkElement" {
  primaryAlarmState: Raw;
  alarmLossOfConnectivityOverride: false;
}

How to customize the alarm representation for predefined business objects to use blinking colors

The following CSS extract shows how you can modify the object representation of JViews TGO predefined business objects to use blinking colors instead of alarm balloon decorations to highlight the presence of new alarms.

This extract illustrates the following configuration:

The alarm balloon decoration is hidden
New alarms are represented in the object base by blinking colors
Outstanding alarms are represented in the object base using the default color configuration
The loss of connectivity status is represented in the object base using the default color configuration

To achieve this configuration, the following CSS properties are used:

alarmBalloonVisible
alarmColorVisible
alarmColor
alarmBrightColor
alarmDarkColor

object."ilog.tgo.model.IltObject" {
  alarmBalloonVisible: false;
  alarmColorVisible: false;
  alarmColor: '';
  alarmBrightColor: '';
  alarmDarkColor: '';
}

object."ilog.tgo.model.IltObject"[alarmHighestSeverity] {
  alarmColorVisible: true;
  alarmColor: '@|severityColor(@|highestSeverity())';
  alarmBrightColor: '@|severityBrightColor(@|highestSeverity())';
  alarmDarkColor: '@|severityDarkColor(@|highestSeverity())';
}

object."ilog.tgo.model.IltObject"[newAlarmHighestSeverity] {
  alarmColorVisible: true;
  alarmColor: '@|blinkingcolor(@|severityColor(@|highestNewSeverity()), 
"#50FFFFFF")';
  alarmBrightColor: 
'@|blinkingcolor(@|severityBrightColor(@|highestNewSeverity()), "#50FFFFFF")';
  alarmDarkColor: '@|blinkingcolor(@|severityDarkColor(@|highestNewSeverity()), 
"#50FFFFFF")';
}

object."ilog.tgo.model.IltObject"["objectState.Alarm.LossOfConnectivity"=true] 
{
  alarmColorVisible: true;
  alarmColor: '@|settings("Alarm.LossOfConnectivity.Color")';
  alarmBrightColor: '@|settings("Alarm.LossOfConnectivity.BrightColor")';
  alarmDarkColor: '@|settings("Alarm.LossOfConnectivity.DarkColor"';  
}

Note

Blinking colors are not supported in table and tree components.

You can also customize the default alarm configuration. For more information, refer to Customizing alarm severities.