Creating Parameters

You can create parameters in an analysis and use them as variables for calculated fields, filters, URLs, custom actions, titles, or descriptions. The parameters that you add in an analysis are available only in that analysis.
To create a parameter:
  1. Click Dashboards tab, the Dashboards tab.
  2. Click Dashboard Designer, in the bottom-left corner.
  3. On the Analyses dialog, click Options button, the Options button, next to an analysis and select Edit.
  4. On the analysis page, click Parameters button, the Parameters button, on the toolbar to display the Parameters panel.
  5. In the Parameters panel, click the + ADD button.
  6. In the Create new parameter dialog, enter a name for the parameter.
    Create new parameter dialog
  7. Under Data type, select String, Integer, Number, or Datetime.
  8. If you selected String, Integer, or Number for the data type, set the parameter values:
    1. Under Values, select Single value for parameters that can contain only one value or Multiple values for parameters that can contain one or more values.
      Parameters with multiple values do not support dynamic default values.
    2. For Static default value or Static multiple default values, enter one or more values.
      The static values are used during the first page load if a dynamic default value or URL parameter is not provided.
    3. To show the default value for multivalue lists as blank, enable the Show as blank by default option.
  9. If you selected Datetime for the data type, set the time granularity and default date:
    1. Under Time granularity, select Day, Hour, Minute, or Second.
    2. For Default date, select Fixed date or Relative date.
      • If you selected Fixed date, specify a date and time.
      • If you selected Relative date, set a rolling date. You can select Today or Yesterday or you can specify a filter condition, range, and period.
  10. Optional: To set a default value that changes for each user, click Set a dynamic default.
    A dynamic default value creates a personalized view for each user. To configure parameters that display different defaults to each user, the dataset must contain a mapping between users or groups and the specific default values that you want them to see.

    Calculated fields cannot be used as dynamic defaults.

  11. Optional: Under Advanced settings, set a reserved value that determines the value for Select all.
    The reserved value of a parameter is the value that is assigned to a parameter when you choose Select all as its value. When you set up a specific reserved value for your parameter, that value is no longer considered a valid parameter value in the dataset.

    You can use the recommended value for the data type, null, or a custom value for the reserved value.

    You can set reserved values only for string, integer, and number parameters.

  12. Click Create.
  13. Select one of the shortcuts from the Parameter added dialog to use the parameter that you created in a filter, control, calculated field, or custom action or click Close.
    For more information, see Adding Controls for Parameters and Connecting to Parameters.

The parameter that you created is displayed in the list of parameters from the Parameters panel. To edit or delete a parameter, hover over the parameter, then click Options icon, the Options icon, and select Edit parameter or Delete parameter.

Parent topic: Using Parameters