Foglight 7.3.0 - Web Component Guide

Table 17. Binding types
Type	Description
Context	A value from the Context, and can select parts of the context using a path (For more information, see Context Tab.).
Data	A bound data value or a list of data values directly, without using a Query. It is always bound to a specific data source. Because it is bound to a specific data instance, it can be used to eliminate an expensive query search (see Data ).
Function	One of the available functions that is to be invoked.
Icon	An icon for display. If no Icon Renderer is specified by the user in the Icon, a default Icon Renderer is used to display the icon at Normal size (see Icon ).
List	A list creation method: creates a list either from individual values, or by merging existing lists. (See List )
Query	A mechanism to calls a named Query to retrieve bound data, and can select parts of the Query's results using a path and other arguments (see Query ).
Rich Text Template	A text template. Like the String Template, only it permits a restricted set of user-entered XHTML. It allows parameters to be set, while Rich Text does not (see Rich Text and Rich Text Template ).
String Template	A simple static text string (such as a String value), but can also perform more complex tasks using parameters (see String Template ).
Theme	A theme based on a Component, Style and Value. For more information, see Theme.
Writable Data Object	A specific data object, chosen from the available data source types. (For more information, see Writable Data Object.)

Details of each Binding

The following types of bindings are available to generate data for views:

•

Context

•

Writable Data Object

•

Data Object Property (and Property)

•

•

•

•

•

Rich Text and Rich Text Template

•

String Template

•

Theme

•

Return Types

Context

Context bindings in a configuration can access any value in the context.


	NOTE: Context cannot have parameters.

The following table describes the properties of a Context:

Items shown when Show Advanced is true are marked with an asterisk (*).

Table 18. Advanced context binding properties

Property

Description

Key

The name by which this item in the context may be referenced. When context objects are defined, a name key is part of the definition, so normally that value is chosen for the key. Access to the object is managed through its name key.

Show Advanced

When enabled, the following propertiesare avilable: Treat as Type, Return Type, Unit Property Name, and Time Range To Use.

Treat as Type

In the Treat as Type field, you can perform a cast to any known subtype of a data element. This is useful when you know that an object is of a particular sub-type but it is passed through an object structure that specifies a more generic type. This happens in cases where the less specific type does not have the properties that you want to access.

You can choose to specify one of the allowable sub-types of the object’s base type. For example, if the context selection is a host, you might choose to restrict it to an AIX_Host.

Path

Context inputs are declared to be of a definite data type. Path is the location of the desired property within the specific data object hierarchy. The Context Entry dialog box displays the actual names of the data-object properties, and not the localized names.

Return First Object in List

If you check Return First Object in List, the first element of the first list that is encountered is set to be a single item. For example, if the context element itself is a list then it uses the first element of the list, instead of the whole list. The optional Path is then applied to that first element.

If, on the other hand, the last element is a list and there are no other lists in the path before it, then the first element of that last list is returned.

If there are two or more lists in the path, only the first one is reduced to its first element.

Renderer

See Renderers .

Return Type

Context can return ten possible types of data:

•