
136 vFoglight
Web Component Guide
to the underlying query, which is executed by the Query Selection. For more
information, see “Parameters in Queries” on page 94.
Parameters in a Query Selection are often used to specify the root path of a query. If the
root is not a parameter, it is an absolute path from the root of the data source. If a query's
root is specified with a parameter reference, then the corresponding parameter from the
Query Selection is assumed to have evaluated to a data object or a list of data objects.
That value is used as the root object for the query.
The behavior becomes more complex if the root is a parameter that evaluates to a list of
data objects, and the query specifies aggregation, such as Max. In this case you have a
choice:
a
Obtain just one aggregate value for the result of the query against all of the
elements in the list of data objects that is the value of the root object's
parameter.
b
Obtain one aggregate value for the result of the query against each element in
the list that is the value of the root object's parameter. The result is a list of
aggregated values.
Note For more information about aggregation, see “Aggregations” on page 82.
For example, you have a view which is a row-oriented table that displays a list of hosts
down the rows. You want to see the maximum severity of events for each host in
another column of the table, which requires using option b. If the root parameter is the
list of hosts, and the aggregate Query is selecting the maximum severity of events, then
the results are a list of the maximum severities of the events for each of the hosts (one
maximum per host).
Configuring the Query Selection
To configure the query selection:
1
Select the Values property of the desired column of the row-oriented table view.
2
Set that property to be a Query Selection accessing the correct query.
3
Check the Iterate Over 1st Parameter in the Query Selection.
Caution Failure to follow these steps results in the query showing just one value for all the
elements in the list (option a).
Kommentare zu diesen Handbüchern