To view sample displays with tutorials, product features, and data source specific examples go to the demos directory, run the data simulators that apply to your Enterprise RTView data sources and start the Display Builder. Open the file alldisplays.rtv and double-click on your selection. NOTE: To learn how to start the Display Builder and run the data simulators refer to the Quick Start Example.

General
The General tab contains flexible objects that can be used to display data and images in addition to executing commands either manually or based on thresholds. To display values on these objects, attach the value property to numeric data and the label property to text data.

General objects that feature the image property can be customized to display your image (.gif, .jpg or .png) file. Click in Property Value field and select the name of the image file from the drop down menu. The drop down menu contains the names of image files located in the current directory, as well as image files located in first level of subdirectories. If an image is not listed, enter the name (including relative path) of the file. To scale your image to the size of the object, check the imageScaleFlag. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

The sample display file general_objects.rtv (located in the tutorials directory) features information on working with objects from the General tab.

Threshold Objects
Objects labeled Discrete Dynamic and Range Dynamic on the General Tab support threshold functionality, allowing you to change the image and color of the object as well as execute a threshold command from the object based on the current value of the value property.  Both the range dynamic and the discrete dynamic objects have the thresholding functionality turned off by default. In the descriptions below, the object's value is the current value of the value property.

Range dynamic objects allow you to setup your threshold so that if the object's value is within a range of numbers, the threshold functionality executes. To enable the high alarm threshold, check the valueHighAlarmEnabledFlag. This will enable several related properties. When the object's value is greater than or equal to the valueHighAlarm property, the background of the object will change to the valueHighAlarmColor, the bitmap on the image will change to the valueHighAlarmImage and the valueHighAlarmCommand will be executed. To enable the high warning threshold, check the valueHighWarningEnabledFlag. When the object's value is greater than or equal to the valueHighWarning, but less than the valueHighAlarm, the background of the object will change to the valueHighWarningColor, the bitmap on the image will change to the valueHighWarningImage and the valueHighWarningCommand will be executed. The low alarm and low warning threshold properties work the same way, but activate when the object's value is less than or equal to the valueLowAlarm or valueLowWarning properties.

Discrete dynamic objects are similar to range dynamic objects, except that the threshold functionality is executed when the object's value equals the threshold value instead of when it is within the range of threshold values. To enable the high alert threshold, check the valueHighAlertEnabledFlag. When the value property equals the valueHighAlert, the background of the object will change to the valueHighAlertColor, the bitmap on the image will change to the valueHighAlertImage and the valueHighAlertCommand will be executed. To enable the medium alert threshold, check the valueMediumAlertEnabledFlag. When the value property equals the valueMediumAlert, the background of the object will change to the valueMediumAlertColor, the bitmap on the image will change to the valueMediumAlertImage and the valueMediumAlertCommand will be executed. The low alert threshold property works the same way, but activates when the object's value is less than or equal to the valueLowAlert property.

For both the discrete dynamic and range dynamic objects, the threshold commands will only execute if the number of seconds specified in the valueCommandTimeout has elapsed since the previous threshold command was executed and the value has changed to another threshold.  For example, if the high warning threshold range is between 40 and 50, when object's value enters this range, the valueHighWarningCommand will be executed. The valueHighWarningCommand will not be executed again until the object's value leaves the high warning threshold range and then re-enters it. If this occurs in less time than is specified in the valueCommandTimeout property, it will not be executed until that time elapses. If the valueCommandTimeout is set to 0, the internal default, 5 seconds, is used.

Labels
The Labels tab includes several types of labels. All of the labels have at least one of the following properties: value, valueString and label.  The value property is used to display numeric data from a data attachment or static value. Some of the label objects which display numeric data also contain scales that display this value, some change color according to this value. The valueString and label properties are used to display text from a data attachment or static value. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

Tables
The Tables tab features three table objects -- standard table, rotated table and object grid -- that offer the ability to display large amounts of data. While most objects are driven by a single variable, table objects are driven by one or two dimensional arrays of data. Table objects are designed to display all the information returned by a tabular element in your data attachment. Based on your data attachment, substitutions are created that will be passed into drill down displays. See the Tables section for more details on working with these objects.

Meters
The Meters tab includes several meters which are useful for displaying data that falls within a known range. You can control the range of data displayed in the meter by setting the valueMax and valueMin properties. The value property should be attached to your data as this property controls the value displayed by the meter. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

Scales
The Scales tab includes several scale objects which are useful for displaying data that falls within a known range. You can control the range of data displayed in the scale by setting the valueMax and valueMin properties. The value property should be attached to your data as this property controls the value displayed in the scale. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

Graphs
The Graphs tab features three types of graph objects -- trend graphs, bar graphs and a pie graph -- that are useful for comparing data. Trend graphs are used to display a single variable per trace over time. Bar and pie graphs are designed to display information returned by a tabular element in your data attachment. Based on your data attachment, substitutions are created that will be passed into drill down displays. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object. See the Graphs section for more details on working with these objects.

Indicators
The Indicators tab features objects useful for displaying discrete alert information. Attach your data to the valueAlert and status properties to display your alerts. Some of these objects change color according to the value being displayed and some will toggle visibility. The last object on the tab displays aggregate alert information. Attach your data to valueTable and the top half of the object will display the color for the highest alert from the data attachment and the lower half will display the relative percents of each alert level from the data attachment. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

Controls
The Controls tab features objects that allow you to issue action commands and update variables that may be used to control other objects in the display. The visFlag property controls the visibility of the object. See the Controls section for more details on working with these objects.

The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object. The properties arrow1VisFlag (source) and arrow2VisFlag (target) control the visibility of source and target arrows on the link. Use linkSize to control the thickness of the link. If you are using a Direct link, selecting the connectEdgeFlag will attach the link to the center of the side closest to the other object (instead of connecting to the center of the object). Orthogonal and Direct Offset links always attach to the center of the side closest to the other object, so the connectEdgeFlag does not affect these links.

If you are using a Direct link, selecting the connectEdgeFlag will attach the link to the center of side closest to other object (instead of connecting to the center of the object). By default, Orthogonal and Direct Offset links attach to the center of the side closest to the other object.

Attach your data to the value property. To display the value of the link, select the iconVisFlag. When iconVisFlag is selected, use iconBgVisFlag to control the visibility of the background rectangle.

Set valueAlertMode property to Discrete Alerts or Range Alerts to enable several additional alert and alarm properties. When set to Discrete Alerts the color of the link will change when the value equals the discrete alarm value, i.e., valueHighAlert, valueLowAlert, valueNoAlert. When the valueAlertMode property is set to Range Alerts the color of the link will change when the value property is greater than the valueHighAlarm or valueHighWarning properties or less than the valueLowAlarm or valueLowWarning properties. Set valueAlertMode to No Alerts to disable all alert and alarm properties.

Alerts
The Alerts tab features objects used in your Alert Configuration file. See the Alerts section for more information.

Composite
The Composite tab features some pre-configured composite objects. The composite object allows you to show a display (.rtv) file within an object. This is useful for creating groups of objects that you want to use multiple times, either directly in your display, or in an object grid. See the Composite page for more information.

Fx Graphs
The Fx Graphs tab features our Adobe® Flash graphs that have been designed specifically for use in the Thin Client deployment. These graphs are similar to other objects featured in the Graphs palette, but support additional interactivity in the Thin Client deployment. See the Fx Graphs section for more information.