1. Home
  2. Cloud
  3. Guides
  4. Tours
  5. Concepts
    1. Aggregate filter
    2. Alias
    3. Apache Avro™
    4. Apache Kafka™
    5. Applied filter
    6. Base table
    7. Bookmark
    8. Business schema
    9. Business schema view
    10. Business schema view column
    11. Business schema view formula column
    12. Column
    13. Connector
    14. Dashboard filter
    15. Dashboard folder
    16. Dashboard runtime filter
    17. Data agent
    18. Data alert
    19. Data destination
    20. Date system variable
    21. Distinct filter
    22. Dynamic Field
    23. Expression
    24. External data source
    25. External session variable
    26. Filter expression
    27. Filter expression session variable
    28. Filter option
    29. Formula column
    30. Formula expression
    31. Full load
    32. Global variable
    33. Incorta Analyzer Table
    34. Incorta Analyzer Table column
    35. Incorta Analyzer Table formula column
    36. Incorta Analyzer View
    37. Incorta Analyzer View formula column
    38. Incorta SQL Table
    39. Incorta SQL View
    40. Individual filter
    41. Insight filter
    42. Internal query expression
    43. Internal session variable
    44. Join
    45. Join condition
    46. Join condition column
    47. Join filter
    48. Join filter column
    49. Level based measure
    50. Load filter
    51. Local data file
    52. Local data folder
    53. Materialized View
    54. Materialized View Column
    55. Materialized View Formula Column
    56. Measure filter
    57. Miscellaneous system variable
    58. Multi-Source table
    59. Physical schema
    60. Physical schema table
    61. Physical schema table column
    62. Physical schema table formula column
    63. Physical schema table runtime security filter
    64. Presentation variable
    65. Prompt
    66. Query system variable
    67. Runtime business view
    68. Runtime business view formula column
    69. Runtime security filter
    70. Session variable
    71. Shared Storage
    72. Upgrade Readiness
    73. Variable
    74. Visualization
  6. Tools
  7. References
  8. Integrations
  9. Data applications
  10. Releases

Concepts → Dashboard Runtime Filter

About a dashboard runtime filter

A dashboard runtime filter is a user-defined filter for a dashboard. A dashboard consumer creates and applies a filter expression through various interactions such as:

  • using the controls in the Filter bar in the dashboard
  • selecting a dashboard tab in the Go To menu in an insight
  • selecting a dimension or measure value in an insight
  • selecting a dimension in the Filter By menu in an insight

For example, for a Listing Table insight, a dashboard consumer may select a value that is a measure. This very insight interaction designates the measure as a filterable column in the filter expression for the dashboard runtime filter.

Once created, the dashboard runtime filter is applied to all applicable insights on all tabs of a given dashboard. The dashboard runtime filter also appears as a filter bar pill.

The filter bar pill shows the filterable column, the filter operator, and depending on the operator, one or more selected filter values.

A dashboard consumer can create a bookmark for an existing dashboard runtime filter.

Note

A dashboard runtime filter differs from a dashboard filter. Whereas a dashboard consumer creates a dashboard runtime filter using the Filter bar or by interacting with an insight, a dashboard developer creates a dashboard filter using a Prompt, Applied Filter, Presentation Variable, or Filter Option.

About a filter expression for a dashboard runtime filter

An example of a filter expression is to return only the rows where the Product Category column has "Electronics" as a row value. In this regard, a filter expression consists of:

  • a filterable column, e.g. Product Category
  • a filter operator, e.g. equals
  • a filter value, e.g. "Electronics"

The filter expression context for a dashboard runtime filter consists of one or more filterable columns.

About a filterable column for a dashboard runtime filter

A filterable column is a column from a physical schema table or runtime business view. A filterable column can be a key, measure, or dimension.

The default behavior of a dashboard is to coalesce a list of dimension columns from all insights on all tabs as filterable columns available in the Filter and Search controls of the Filter bar.

Note

A user interaction with a measure on an insight create a filterable column that is a measure. The filter bar pill for is editable. In this manner, a dashboard consumer can modify the filter operator or filter value for a filterable column that is a measure.

About a filter operator for a dashboard runtime filter

A filter operator defines the operation for the filter expression. The available operators depends on the data type of the filterable column.

OperatorDateTimestampIntegerLongDoubleStringText
Equalsxxxxxxx
Does Not Equalxxxxxxx
Greater Thanxxxxxxx
Greater Than or Equalsxxxxxxx
Less Thanxxxxxxx
Less Than or Equalsxxxxxxx
Null (an absence of any value)xxxxxxx
Not Null (must contain a value)xxxxxxx
In ( as In a list of one or more values)xxxxxxx
Not In ( as Not In a list of one or more values)xxxxxxx
Starts Withx
Does Not Start Withx
Containsx
Does Not Containx
Ends Withx
Betweenxxxxxxx
Is Descendantxxxxxx

About a filter value for a dashboard runtime filter

A filter value depends on the filter operator and is typically one of the following:

  • one or more values that you select within the index of the filterable column values
  • one or more values that you enter
  • a range of values such as a Start Date and End Date or From and To

A filter value can be a scalar value, array of scalar values, or a reference to a variable as follows:

About an applicable insight for a dashboard runtime filter

A dashboard runtime filter applies the filter expression to all applicable insights on all tabs of a given dashboard.

For a filterable column, an applicable insight meets one of the following conditions:

  • the filterable column is a dimension or measure column in the insight
  • the filterable column has a sibling dimension column from the same physical schema table, and that sibling is a dimension for the insight
  • the filterable column is a dimension that shares a measure on the insight from a common child table with other dashboard insights

If an applicable insight already contains an insight individual filter, a dashboard runtime filter will complement the insight individual filter based on a common filterable column as described above.

Important: Incorta Analyzer View

If a filterable column is from an Incorta Analyzer View, the applicable insight must contain only measures or dimensions from that Incorta Analyzer View. Similarly, a filterable column is not from an Incorta Analyzer View, the applicable insight must not contain measures or dimensions from an Incorta Analyzer View.