Customizing output parameters

CDP Data Visualization application controls may 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. In CDP Data Visualization, you can correctly specify this mapping by setting the value of the filter to the appropriate field in the target dataset.

The following steps demonstrate how to configure a filter based on US Populations Over Time dataset to control the display in a visual based on 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 Visuals tab on left navigation, and add the visuals to the application.
  3. Click the Filters tab, and select the dataset US State Populations Over Time.
  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 Values tab.
  8. Set the values:

    Note that From Base Field has the value state and cannot be changed.

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

    Note that 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.