Loading...

Adding Inputs to Reports

You can add inputs to a report to add interactivity for the report end user. Report inputs are user interface elements such as drop-down lists, check boxes, or radio buttons that allow users to select values that filter report data.

Before You Begin

Procedure

  1. On the Web Console for the Private Metrics Reporting Server, click Reports.

    The Worldwide Dashboard appears.

  2. At the top of the page, click Worldwide Reports, click Report Manager , and on the Reports tab, next to the Report Name under Actions, click Edit.

    The Report Builder page appears.

  3. On the Inputs tab, click Create an Input .

    For details about the options in this dialog box, see Edit Report Input Dialog Box.

  4. In the Add Report Input dialog box, configure how the input appears in the report:
    1. In the Input Variable box, type a field name from the data set.

      This name must be unique so that it can be used to associate the report input with the data set.

    2. In the Display Name box, type the name of the input that will appear in the report.
    3. In the Input Variable Type list, select the type of input that you want users to enter, such as String, Boolean, or Date.
    4. In the Input Control Type list, select the type of input that you want users to see, such as a Drop Down list, Check Box, or Radio Button.

      For more information, see Input Controls for Build Your Own Reports.

    5. To hide the input from report end users, select Hide Input.
    6. To allow end users to select more than one value in the input, select Allow Multiselection.

      If you select Allow Multiselection, you must also select Multi when you associate the report input with the data set.

    7. To make the input optional or required for viewing the report data, select Optional or Required.
    8. Optional: In the Default Value box, type the input value that you want displayed by default.

      If you are creating a custom date range, you can configure a default date and time by using PnYnMnDTnHnMnS from the XSD (XML Schema Definition) Duration data type.

  5. To use fixed values that you will specify, select Manual.
    1. In the Possible Labels box, type display names for the values that you want the user to see.
    2. In the Possible Values box, type the values that correspond to the labels.

      This is the value that will be assigned to the data set parameter.

      These are also the value names that the user will see.

  6. To use dynamic values from a data set, select Data Set.
    1. In the Data Set list, select the data set you want to use for input values.
    2. In the Value Field list, select a field name from the data set.

      These are the value names that the user will see.

    3. In the Label Field list, select the field name that will be assigned to the Parameter that you will create when you associate the data set with the report input in the data set query.

  7. To use a date range, configure the date range options:
    1. Under Options, select one or more of the date entry types the user will see.
    2. Under Allowed Units, select one or more of the time units the user will see.

  8. Click Done.

    The input appears at the top of the report.

What to Do Next