Open topic with navigation

Configuring Parameter Value Groups

Some reports may require users to provide multiple run-time values that would be easier to select if they were grouped. Following the previous example, a report that requires a user to select more than one country name might be a good candidate for parameter value groups. Users might find it difficult to select a few country names from a single, long list of countries.

As an alternative, the query designer could create parameter value groups for the Americas, Europe, Asia, Africa, and so forth. Each parameter value group would contain lists of countries belonging to those continents or areas. At report run time, when the user selects a group, values belonging to the group are pre-selected. Users do not have to manually select countries in parameter groups for every report run. Selections are saved from one report run to the next.

Using parameter value groups as part of your query design strategy can save users time and reduce error at report run-time.

To view and work with Logger Report parameter value groups, under Design, click Parameter Value Groups on the Reports left panel.

The following table describes the options on the Parameter Value Groups page.

Parameter Value Groups

Option

Description

Name

Lists all the parameter objects.

Available Values

Lists available values for the selected parameter.

Value Groups

Lists groups created and the values selected within a group. An icon is displayed on the left of a Private group.

Show All Owners

If selected, displays groups created by all users.

Option buttons:
Private
Public

Select Private to list the groups you have set for you only.

Select Public if you wish to list the groups you have set for everyone.

To create a group:

  1. Click (Add Group) next to the Value Groups box. A group is created and listed under Value Groups with a default name (based on the currently selected parameter in Parameters list).
  2. In the Value Groups list, edit the new group name as needed. (Double-click the name to edit it, if it is not already in edit mode.) Double-click the name again to set it, or click outside the box.
  3. Add the values you want in the group by selecting a value in Available Values list and clicking (Add value to selected group) button. The selected value is added to the selected group in the Value Groups list.

  4. Repeat the previous step for each value you want to add to the group.

    If a value that you want to add to a group is not listed in Available Values list, specify the value in Additional Value field (under Available Values) press Return key. The custom value is added to the currently selected group.

    Select an Available Value and click to add all the values to the selected group in Value Groups, click to remove the selected value from Value Groups, and click to remove all the values from Value Groups box.

    Select a group and click up and down arrows to move the selected group up or down. Select a value and click up and down arrows to move the selected value up or down (within the group).

  5. Click Save.

    If the name of a group is changed by a user, the values under that group will be removed from the Selected Values group of that user's preferences.

To create a tree view parameter:

  1. Click the leaf node and click the right arrow button.