Customizing Performance secondary states

Performance states explains how to customize the object representation according to the Performance state information. You can also customize the decoration that is displayed when a given Performance secondary state is set in the object.

In the Performance state dictionary, the secondary states are numeric and by default they are represented by a gauge. There are also two other possible representations for these states. The IltDecorationType class defines the possible graphical representations. The possible values of this class are:

Gauge
Chart
Counter

How to customize a Performance secondary state decoration (using the API)

Performance secondary states can be displayed as charts, gauges or counters. By default, the gauge decoration is used. If you want to indicate that you are going to use another type of representation, without changing the default configuration for each representation, modify the secondary state information as follows:

IltSettings.SetValue("Performance.SecState.Imput.Type", 
IltDecorationType.Chart);

The property to be set is built in the following way: “<STATE NAME>.Type”. For example, Performance.SecState.In.Type or Performance.SecState.Voltage.Type .

How to customize a Performance secondary state decoration (using CSS)

You can also customize a performance secondary state decoration by using global CSS settings (see Using global settings in Using Cascading Style Sheets for more information):

You must specify the full state name, for example " Performance.SecState.Input ", when matching the " name " attribute. The CSS property to be customized is type .

setting."ilog.tgo.model.IltState"[name="Performance.SecState.Input"] {
   type: Chart;
}

How to modify the Gauge graphical representation of a Performance secondary state (using the API)

When a Performance secondary state is graphically represented by a gauge decoration, the configuration of this decoration has to be previously defined. All Performance secondary states have a predefined gauge representation.

For information on how each secondary state is graphically represented, refer to

Suppose you have a secondary state that is configured with a gauge decoration as follows.

IltSettings.SetValue("Performance.SecState.Input.Type", 
IltDecorationType.Gauge);

You can modify this decoration in the following way.

IltColorModifier modifier1 = new IltColorModifier.Shade(0.5f);
IltColorModifier modifier2 = new
    IltColorModifier.MultiColor(IltColorModifier.MultiColor.USE_LAST_VALUE);
IltColorModifier modifier = modifier1.compose(modifier2);

IltGaugeMapping mapping = (IltGaugeMapping)
    IltSettings.GetValue("Performance.SecState.Input.Gauge");
mapping.setColorModifier(modifier);

You can also create a new gauge mapping, and set the new value in the following way.

IltGaugeMapping mapping = new IltGaugeMapping(minImg, maxImg);
IltSettings.SetValue("Performance.SecState.Input.Gauge", mapping);

How to modify the Gauge graphical representation of a Performance secondary state (using CSS)

You can also customize the gauge graphic representation by using global CSS settings. You must specify the full state name, for example " Performance.SecState.Input ", when matching the " name " attribute. The CSS property to be customized is gauge .

When defining a new gauge mapping class, the following CSS properties are used: minImage , maxImage , direction , colorModifier . They match corresponding set methods of the IltGaugeMapping class (and its super class). Refer to ilog.tgo.graphic.IltGaugeMapping for information on how to customize the gauge decorations.

In the following example, the color modifier class named MyColorModifier has been created and included in the search path.

setting."ilog.tgo.model.IltState"[name="Performance.SecState.Input"] {
  gauge: @+gaugePerf;
}
Subobject#gaugePerf {
  class: 'ilog.tgo.graphic.IltGaugeMapping';
  minImage: '@|image("icon1.png")';
  maxImage:'@|image("icon2.png")';
  direction: Bottom;
  colorModifier: @+myColorModifier;
}
Subobject#myColorModifier {
  class: "MyColorModifier";
}

How to modify the Chart graphical representation of a Performance secondary state (using the API)

When a Performance secondary state is graphically represented by a chart decoration, the configuration of this decoration has to be previously defined. All Performance secondary states have a predefined chart representation. Refer to Performance states: the Performance state dictionary in the Business Objects and Data Sources documentation for information on how each secondary state is graphically represented.

Suppose you have a secondary state that is configured with a chart decoration as follows.

IltSettings.SetValue("Performance.SecState.Input.Type", 
IltDecorationType.Chart);

You can modify this decoration in the following way.

IltColorModifier modifier1 = new IltColorModifier.Shade(0.5f);
IltColorModifier modifier2 =
  new IltColorModifier.MultiColor(IltColorModifier.MultiColor.USE_LAST_VALUE);
IltColorModifier modifier = modifier1.compose(modifier2);

IltChartMapping mapping = (IltChartMapping)
    IltSettings.GetValue("Performance.SecState.Input.Chart");
mapping.setColorModifier(modifier);

You can also create a new chart mapping, and set the new value in the following way:

IltChartMapping mapping = new IltChartMapping(minImg, maxImg);
IltSettings.SetValue("Performance.SecState.Input.Chart", mapping);

How to modify the Chart graphical representation of a Performance secondary state (using CSS)

You can customize the chart graphic representation using global CSS settings. You must specify the full state name, for example " Performance.SecState.Input ", when matching the " name " attribute. The CSS property to be customized is chart .

When defining a new chart mapping class, the following CSS properties are used: minImage , maxImage , xAxisDirection , yAxisDirection , colorModifier . They match corresponding set methods of the IltChartMapping class (and its super class). Refer to ilog.tgo.graphic.IltChartMapping for information on how to customize the chart decorations.

In the following example, the color modifier class named MyColorModifier has been created and included in the search path.

setting."ilog.tgo.model.IltState"[name="Performance.SecState.Input"] {
  chart: @+chartPerf;
}
Subobject#chartPerf {
  class: 'ilog.tgo.graphic.IltChartMapping';
  minImage: '@|image("icon1.png")';
  maxImage:'@|image("icon2.png")';
  xAxisDirection: Right;
  yAxisDirection: Bottom;
  colorModifier: @+myColorModifier;
}
Subobject#myColorModifier {
  class: "MyColorModifier";
}

How to modify the Counter graphical representation of a Performance secondary state (using the API)

When a Performance secondary state is graphically represented by a counter decoration, the configuration of this decoration has to be previously defined. All Performance secondary states have a predefined counter representation. For information on how each secondary state is graphically represented, refer to

Suppose you have a secondary state that is configured with a counter decoration as follows.

IltSettings.SetValue("Performance.SecState.Input.Type", 
IltDecorationType.Counter);

You can modify this decoration in the following way.

IltCounterMapping cm = new IltCounterMapping(new DecimalFormat("#Mbs"),
                                             IltrFont.CounterText,
                                             true, Color.black, 
                                             Color.white, Color.black,
                                             3, 1, IlvDirection.Right, false);
IltSettings.SetValue("Performance.SecState.Input.Counter", cm);

How to modify the Counter graphical representation of a Performance secondary state (using CSS)

You can customize the counter graphical representation by using global CSS settings. You must specify the full state name, for example " Performance.SecState.Input ", when matching the " name " attribute. The CSS property to be customized is counter .

When defining a new counter mapping class, the following CSS properties are used: format , font , antialiasing , foregroundColor , backgroundColor , borderColor , xPadding , yPadding . They match corresponding set methods of the IltCounterMapping class (and its super class). Refer to ilog.tgo.graphic.IltCounterMapping for information on how to customize the counter decorations.

setting."ilog.tgo.model.IltState"[name="Performance.SecState.Input"] {
  counter: @+counterPerf;
}
Subobject#counterPerf {
  class: 'ilog.tgo.graphic.IltCounterMapping';
  format: @+myNumberFormat;
  font: "Helvetica-Bold-12";
  antialiasing: false;
  foregroundColor: red;
  backgroundColor: blue;
  borderColor: red;
  xPadding: 100;
  yPadding: 100;
}
Subobject#myNumberFormat{
  class: 'MyNumberFormat';
}

Current section

Customizing the Performance State System