OneSight Administrator Guide

Global Metric Manager
Query result – Lets you run reports using the numeric or string
result of the query.
Perl Expression – Enter the numeric value that should be returned
for the query you specified. If this metric returns a string that
contains more than just numerical information, then a regular
expression can be used in Match string to extract the numerical
result that OneSight requires. For more information, see Using
Regular Expressions for Pattern Matching in Chapter 5.
String Mappings – Use this button to display the String Mappings
dialog box for entering a string that should be returned for the
query you specified.
OneSight collects numeric performance data. If you are
measuring a JDBC result representing a string datatype, it can be
converted to a number for use in OneSight by using the String
Mappings field. Specify a semicolon delimited mapping of
strings to integers. For example, ―false=0;true=1‖ converts a false
reading to a zero value in OneSight. String mappings can also be
used to translate a number to a string for display in OneSight.
Note: When the output of a database query is a result set the query
retrieves all rows of the result set. It processes for good content
match, perl expression match, or advanced string mapping, treating
the entire result set as a whole data block. Matching is successful
when there is at least one match in the whole data block. If the
result needs to be returned, the first matched value is returned.
Return the first column of the first row – Select this option to return
the first column of the first row if there are multiple results.
Loop on result items, returning the first match – Select this option to
loop on each result and return the first result that matches.
Concatenate result items (space delimited) – Select this option to
concatenate all results and return the first result that matches.
Results are space delimited.
Chapter 6: Using Profiles 525