Customizing output parameters

application controls can use custom output parameters. You can apply a filter defined in one dataset to control visual presentation based on information in another dataset. In most cases, there is a mismatch between the field names of the driver and target datasets. You can correctly specify this mapping by setting the value of the filter to the appropriate field in the target dataset.

The following steps show you how to configure a filter based on the US Populations Over Time dataset to control the display in a visual based on the US County Population dataset.

  1. Open an existing or new application in Edit mode.
  2. Ensure that it has appropriate visuals from both datasets. If not, click the Visuals tab on the left navigation, and add the visuals to the application.
  3. Click the Filters tab, and select the US State Populations Over Time dataset.
  4. Under Dimensions, click the field state to add the filter to the application.
  5. Hover over a filter that is already added to the application until the controls appear on the top right.
  6. Click the Gear icon.

    The Settings modal window appears.

  7. In the Settings modal window, click the Values tab.
  8. Set the values:
    • Set Title to States.
    • Set Output Parameter to stname.
  9. Click Apply.
  10. In the state filter, click Select and chose the following:
    • AK
    • AL
    • AR
  11. In the top right corner of the application, hover over the Filter icon control element.

    This reports the current filtering parameters, correctly naming the output parameter field stname, and correctly identifying the filtering conditions set earlier.

    If the option to Emit distinct parameters for each item selected is selected (under Display Settings tab), the filter reports the items as distinct key/value pairs. By default, the label for each key is derived from its value. If the labels are specified, such as in the case of optional parameters, they appear instead.