Dropdown List Selector: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
(Created page with "The Dropdown List Selector is used to add dynamic behavior to dashboards by allowing users to make selections that affect the dashboard. The component shows a dropdown list wh...")
 
No edit summary
Line 1: Line 1:
The Dropdown List Selector is used to add dynamic behavior to dashboards by allowing users to make selections that affect the dashboard. The component shows a dropdown list where user can select a value from a list of available values. The dropdown list is linked to other components of the dashboard as follows: The selected value is stored to a variable, which is used by the other components.
''Dropdown List Selector''' adds dynamic behavior to dashboards by allowing users to make selections that affect charts and other components in the dashboard. The Dropdown List Selector is usual dropdown list where user can select a value from a list of predefined values. The dropdown list is linked to other components of the dashboard using variables: The selected value is stored to a variable, which is used by the other components. The Dropdown List Selector can be configured flexibly based on any data in the model, and the contents of the list changes automatically when the model data changes. Note that the Dropdown List Selector is not related to the filters of the dashboard.


The Dropdown List Selector can be configured flexibly to show any kind of data from the model in a dynamic way. Note that the Dropdown List Selector is not linked to the filters of the dashboard.
When adding a Dropdown List Selector, the linked variable needs to be defined to the dashboard as follows:
 
# When in dashboard designer, click the dots menu on top right and click '''Dashboard Properties'''.
When using the Dropdown List Selector, the linked variable needs to be defined to the dashboard as follows:
# Open the '''Variables''' tab.
# Click the dots menu on top right and click '''Dashboard Properties'''.
# Define a name for the variable in the textbox. The name can be chosen freely.
# Open '''Variables''' tab.
# Define a name for the variable in the textbox.
# Set the behavior to be '''Stored variable'''.
# Set the behavior to be '''Stored variable'''.
# Click the '''Done''' button on top right, and save the dashboard.
# Click the '''Done''' button on top right.
# The variable needs to be defined also to the Dropdown List Selector settings in the ''Variable name'' field.
# Save the dashboard.


Dropdown List Selector has the following settings:
Dropdown List Selector has the following settings:
* Title: Title/label of the dropdown list. If no title is defined, an automatic title is derived based on the chosen ''List items'' .
* '''Title''': Explaining title or label for the dropdown list that is visible in the dashboard. If no title is defined, an automatic title is derived based on the chosen ''List items'' .
* Analyzed objects: Types of objects where the list items are derived. Based on this selection, there are different options available for the ''List items'' and ''1. measure''.
* '''Analyzed objects''': Types of objects where the ''List items'' are derived. Based on this selection, there are different options available for the ''List items'' and ''1. measure''. The Analyzed objects selection works similarly as the same selection in charts.
* Sorting: Order in which items are shown in the list.
* '''Sorting''': Defines a column based on which items are sorted in the list. The ''1. dimension'' means sorting based on the ''List items''.
* Maximum rows: Maximum number of items shown by the list. This setting can be used to show only the most important items.
* '''Maximum rows''': Maximum number of items shown by the list. This setting can be used to show only the most important items. Note that the list can smoothly show maximum of couple of thousand of items, so the maximum rows limitation is also needed from the dashboard performance viewpoint.
* Variable name: Name of the linked variable. When user makes a selection in the list, this variable value is changed.
* '''Variable name''': Name of the variable that is linked to this dropdown list. When user makes a selection in the dropdown list, the selection is stored to the variable.
* 1. measure: The list can optionally show aggregated information for each of the listed items in parenthesis. When the measure is selected, possibility to define a second measure appears.
* '''1. measure''': The list can optionally show aggregated information for each of the listed items in parenthesis. When the measure is selected, possibility to define a second measure appears.
* List items: Select what kind of items the dropdown list is showing.
* '''List items''': Select what kind of items the dropdown list is showing. There are variety of options to choose from, and the options depend on what has been selected as the ''Analyzed objects''. This selection is similar to the dimension selection in charts.
* Same [[QPR_ProcessAnalyzer_Chart#Layout_Settings|layout settings]] as in charts.
* Same [[QPR_ProcessAnalyzer_Chart#Layout_Settings|layout settings]] as in charts.

Revision as of 08:19, 11 August 2021

Dropdown List Selector' adds dynamic behavior to dashboards by allowing users to make selections that affect charts and other components in the dashboard. The Dropdown List Selector is usual dropdown list where user can select a value from a list of predefined values. The dropdown list is linked to other components of the dashboard using variables: The selected value is stored to a variable, which is used by the other components. The Dropdown List Selector can be configured flexibly based on any data in the model, and the contents of the list changes automatically when the model data changes. Note that the Dropdown List Selector is not related to the filters of the dashboard.

When adding a Dropdown List Selector, the linked variable needs to be defined to the dashboard as follows:

  1. When in dashboard designer, click the dots menu on top right and click Dashboard Properties.
  2. Open the Variables tab.
  3. Define a name for the variable in the textbox. The name can be chosen freely.
  4. Set the behavior to be Stored variable.
  5. Click the Done button on top right.
  6. The variable needs to be defined also to the Dropdown List Selector settings in the Variable name field.
  7. Save the dashboard.

Dropdown List Selector has the following settings:

  • Title: Explaining title or label for the dropdown list that is visible in the dashboard. If no title is defined, an automatic title is derived based on the chosen List items .
  • Analyzed objects: Types of objects where the List items are derived. Based on this selection, there are different options available for the List items and 1. measure. The Analyzed objects selection works similarly as the same selection in charts.
  • Sorting: Defines a column based on which items are sorted in the list. The 1. dimension means sorting based on the List items.
  • Maximum rows: Maximum number of items shown by the list. This setting can be used to show only the most important items. Note that the list can smoothly show maximum of couple of thousand of items, so the maximum rows limitation is also needed from the dashboard performance viewpoint.
  • Variable name: Name of the variable that is linked to this dropdown list. When user makes a selection in the dropdown list, the selection is stored to the variable.
  • 1. measure: The list can optionally show aggregated information for each of the listed items in parenthesis. When the measure is selected, possibility to define a second measure appears.
  • List items: Select what kind of items the dropdown list is showing. There are variety of options to choose from, and the options depend on what has been selected as the Analyzed objects. This selection is similar to the dimension selection in charts.
  • Same layout settings as in charts.