Issue:
A user would like to change the default background colors for the high and low bounds on a numeric object.

Product Line:
ION Enterprise
StruxureWare Power Monitoring
StruxureWare Power Monitoring Expert

Environment:
Webreach / Web Applications Diagrams

Cause:
Support for high/low limit flags in WebReach was added to ION Enterprise 5.0 SP5 and ION Enterprise 5.5 SP1. However in WebReach, unlike Vista, the flag colors used are hard-coded in one of the WebReach style sheets. This article describes how to edit the style sheet file to change the flag colors. Note that this setting is global and all WebReach users will see the same colors.

Resolution:
Caution: ALWAYS make a copy of any file before editing it in case of error and it becomes necessary to revert to the original file.

This procedure is to change the background colors on simple numeric objects when they reach the high or low bounds. This procedure is not intended to change the high and low band colors on Dials or Gauges. Dial and Gauge high and low band colors are hard-coded to red and blue within the ION Enterprise software and cannot be changed.

Procedure for ION Enterprise (all supported versions) and Struxureware Power Monitoring 7.0

The file that must be edited is called "vista_prototype.xsl" and is located in the "...\system\webreach\includes" directory on the ION Enterprise/Struxureware Power Monitoring primary server. To find the section of the file that must be edited, open the file in a text editor and search for "00ff". The resultant code should look like:

else if (value > highBound)
{
// use a red background
parentTable.style.background = "#ff0000";
}
else if (value < lowBound)
{
// use a blue background
parentTable.style.background = "#0000FF";
}

The hexadecimal areas above indicate the color used for flags. To change colors, simply edit the 'parentTable.style.background' value using the appropriate code from the table below.


Procedure for Struxureware Power Monitoring 7.0.1 (WebReach was refactored in this release) and StruxureWare Power Monitoring Expert 7.2.x

The file to alter is called "realtime.js" and is in the "...\system\webreach\scripts" folder.

The new code snippet to change is:

if (rawValue > Number(highBound)) {
// use a red background
color = '#ff0000';
}
else if (rawValue < Number(lowBound)) {
// use a blue background
color = '#0000ff';
}

Procedure for Power Monitoring 8.0 (the flag colors now support more ranges)

The file to alter is still named "realtime.js" and is in the "...\system\webreach\scripts" folder but the code needs to be edited in a different place.

The new code snippet to change is:

if (m_HiHiFlagColor === undefined) {
var m_HiHiFlagColor = "#ff0000"; // red
var m_HighFlagColor = "#ff8000"; // orange
var m_LowFlagColor = "#00b8ff"; // light blue
var m_LoLoFlagColor = "#0000ff"; // blue
if (m_ErrorFlagColor === undefined) {
var m_ErrorFlagColor = m_HighFlagColor
var m_StaleFlagColor = "#ffff00"; // yellow
}
}

You will need to set the color variables above to the colors from the palette that you would like to see.

The IIS Admin Service must be restarted for any changes to take effect.