Table
The Table widget allows you to organize and structure data from dimensions and apply measures to them. To build this widget, first add a table to your Data Model.
Widget Settings
In addition to the common widget settings, this widget has unique configuration options.
Data Settings
Dimensions and Measures
The following common settings are available for both dimensions and measures:
- Title
- Formula
- Format
- Formatting
- Width (in pixels or percentages)
- View
- Display (Always / By variable / By formula)
Additionally, for dimensions you can hide empty values and assign click actions.
View settings differ between dimensions and measures.
Dimension View
This parameter controls value coloring for dimensions in the table. Available options:
- No coloring
- Text coloring
- Cell background coloring
For dimensions with Integer or Float data types, when coloring is enabled, you can choose among By values, By rule, or By range. To define colors, click the gear icon in the style settings field. In the panel that appears, click + Rule.
From the dropdown list, select the value for which coloring is being configured. Color modes available: Solid or By rule.
When coloring by range, values outside the defined range are also colored. These values are displayed with the same bar size and color as the nearest value within the range. For example, if the upper range boundary is 370 and the table contains values exceeding this, they will use the same coloring as the value 370. This coloring logic also applies to negative values.
Measure View
This parameter controls how measure values are colored in the table. Available options:
- Disabled (default)
- Text coloring
- Cell coloring
- Table coloring
- Table coloring by defined range
- Indicator with arrow (growth/decline)
When Table coloring by defined range is selected, minimum and maximum values for the View setting are set automatically:
- In Duration format: units of measurement appear as a hint in the range settings field
- In Number format: as the specified value
The View setting appears only for measures with numeric data types. If all values in a measure column are identical, gradient coloring is not applied.
For aggregated indicators, chart settings are available:
- Minimum value (by default, the table’s minimum value is treated as 0%. Values at or below this threshold are considered 0%).
- Maximum value (by default, the table’s maximum value is treated as 100%. Values at or above this threshold are considered 100%).
- Units of measurement (for Duration format): days/hours/minutes/seconds
To display the chart, you must configure at least one dimension.
Formulas for dimensions and measures can be changed via a dropdown list. Detailed information about the formula editor is available on the corresponding page.
Display Settings
Text Size
Adjusts the text size within widget rows.
Alignment
Allows you to set vertical alignment of cell content to either the top or center. This setting affects all types of content in cells—text, checkboxes, colored bars, etc.
Table Header Settings
- Header background: Auto / Solid
- Font weight: Normal / Bold
- Text color: Auto / Solid
Row Limit
Limits the number of rows displayed per table page to the specified value.
Hide Empty Values
Hides empty values in the table.
Totals
When enabled, a Totals row is added to the table. The row displays the extreme value of the measure column, calculated using the same formula applied to the measure itself. For example, if the measure formula is min(...), the summary value will be the minimum across the entire column data range.
Additional settings for the Totals row include:
- Background (Auto / Solid)
- Font weight
- Text color
These settings are only available when the Totals row is enabled.
Selected Totals row settings (e.g., color) are preserved even when the row is hidden. Re-enabling the row will restore its previous styling.
Filtering Settings
General filtering settings apply to this widget.
Filters configured within the widget cannot be removed in Browse mode.
Action Settings
In the Buttons tab, you can configure script execution from the dashboard.
After selecting a script, a button appears above the table. Clicking it runs the script. Multiple actions can be added to a table, resulting in multiple buttons displayed above it.
Browse Mode
In Browse mode, you can search for specific values within a dimension directly in the table. The search field is located in the column header. You can find and select multiple values; once selected, a filter is applied to the entire dashboard—just as if you had clicked those values directly in the column.
Pagination is handled via a navigation panel in the bottom-right corner of the widget. This panel appears automatically when the number of rows exceeds the value set in the Row limit parameter.
Widget Configuration in YAML
You can configure the widget not only visually but also in the YAML editor. The table below lists the keys and values available for configuration. For details on using the value key, see Dimension and Measure Values in YAML. Supported data formats are described on the corresponding page. General widget parameters are covered in Widget Configuration in YAML.
Data Settings in YAML
| Key | Type | Definition |
|---|---|---|
| title | string | Title |
| showMarkdown | boolean | Description |
| markdownText | string | Description text |
| markdownMeasures | — | Measure in description |
| dimensionsAndMeasures | — | Dimensions and measures |
| sorting | — | Sorting |
Dimensions and Measures in YAML (key: dimensionsAndMeasures)
To add a dimension or measure to the widget, use the dimensionsAndMeasures block. The keys below are used within this block.
| Key | Type | Definition |
|---|---|---|
| name | string | Indicator title |
| type | enum | Indicator type: - DIMENSION — dimension- MEASURE — measure |
| value | — | Event indicator formula |
| dbDataType | enum | Event indicator data type |
| format | enum | Format |
| formatting | enum | Formatting |
| formattingTemplate | string | Custom formatting Only for CUSTOM formatting |
| hideEmptyValues | boolean | Hide empty values |
| hierarchyDimensions | — | Hierarchy dimensions If this parameter is added, the indicator is defined as a hierarchy Only for DIMENSION |
| onClick | — | Click actions Only for DIMENSIONNot applied if the indicator is hierarchical |
| width | number | Width |
| displaySign | number | View: - NONE — disabled- TEXT — text coloring- FILL — cell coloring- DIAGRAM — table coloring- DIAGRAM_IN_RANGE — table coloring by defined range- INDICATOR — indicator with arrow (growth/decline)Only for MEASURE |
| color | — | Color: - AUTO — auto- GRADIENT — by gradient- FORMULA — by formula- RULE — by ruleOnly for: - TEXT- FILL- DIAGRAM- DIAGRAM_IN_RANGE |
| range | — | Range Only for DIAGRAM_IN_RANGE |
| displayCondition | — | Display (display condition) |
| arrayNesting | boolean | Array nesting |
Hierarchical Dimension (key: hierarchyDimensions)
| Key | Type | Definition |
|---|---|---|
| name | string | Hierarchy dimension title |
| value | — | Event indicator formula |
| dbDataType | enum | Event indicator data type |
| format | enum | Format |
| formatting | enum | Formatting |
| formattingTemplate | string | Custom formatting Only for CUSTOM formatting |
| hideEmptyValues | boolean | Hide empty values |
| displayCondition | — | Display (display condition) |
| arrayNesting | boolean | Array nesting |
Range in YAML (key: range)
| Key | Type | Definition |
|---|---|---|
| unit | enum | Unit of measurement: - SECONDS — seconds- MINUTES — minutes- HOURS — hours- DAYS — days |
| min | number | Minimum value |
| max | number | Maximum value |
Display Settings in YAML
| Key | Type | Definition |
|---|---|---|
| paddings | string | Side paddings |
| titleSize | number | Title size |
| titleColor | — | Title color: - AUTO — auto- BASE — solid |
| titleWeight | enum | Font weight: - NORMAL — normal- BOLD — bold |
| markdownTextSize | number | Markdown description text size Available only if Description is enabled |
| textSize | number | Text size |
| rowsLimit | number | Row limit |
| showTotal | boolean | Totals toggle |
| totalTextColor | — | Totals row text color: - AUTO — auto- BASE — solid |
| totalWeight | enum | Totals row font weight: - NORMAL — normal- BOLD — bold |
| totalColor | — | Totals row background color: - AUTO — auto- BASE — solid |
| hideEmptyValues | boolean | Hide empty values |
| verticalAlign | enum | Alignment: - TOP — top- CENTER — center |
| headTextColor | — | Table header text color: - AUTO — auto- BASE — solid |
| headWeight | enum | Table header font weight: - NORMAL — normal- BOLD — bold |
| headColor | — | Table header background: - AUTO — auto- BASE — solid |
Filtering Settings in YAML
| Key | Type | Definition |
|---|---|---|
| filterMode | enum | Filter mode: - DEFAULT — default- SINGLE — single selection- DISABLED — disabled |
| ignoreFilters | boolean | Ignore filters |
| filters | — | Filters |
| aggregateFilters | — | Aggregate filters |
| stateName | string | State |
Action Settings in YAML
| Key | Type | Definition |
|---|---|---|
| actions | — | Actions |
Example of a Configured Widget in the YAML Editor
- key: table
apiVersion: "16"
type: TABLE
settings:
displayCondition:
mode: VARIABLE
variableName: null
variableValue: null
dimensionsAndMeasures:
- displayCondition:
mode: VARIABLE
variableName: null
variableValue: null
dbDataType: STRING
onclick: []
name: Scenario
format: STRING
type: DIMENSION
value:
mode: FORMULA
formula: '"case_table"."scenario"'
formatting: AUTO
onClick: []
- displayCondition:
mode: VARIABLE
variableName: null
variableValue: null
color:
mode: FORMULA
formula: ""
formattingTemplate: ""
dbDataType: INTEGER
name: Quantity
format: NUMBER
type: MEASURE
value:
mode: FORMULA
formula: count(distinct "case_table"."incident_id")
formatting: AUTO
displaySign: FILL
- displayCondition:
mode: VARIABLE
variableName: null
variableValue: null
formattingTemplate: ""
dbDataType: FLOAT
name: Duration
format: DURATION
type: MEASURE
value:
mode: FORMULA
formula: >-
median(
if(
process(
countIf("event_log"."event_name" = 'Opening') > 0 and countIf("event_log"."event_name" = 'Closing') > 0, "case_table"."incident_id"
),
process(
date_diff(
second,
minIf("event_log"."event_time", "event_log"."event_name" = 'Opening'),
maxIf("event_log"."event_time", "event_log"."event_name" = 'Closing')
),
"case_table"."incident_id"
), 0
)
)
formatting: AUTO
displaySign: DIAGRAM
color:
mode: AUTO
textSize: 12
showMarkdown: false
ignoreFilters: false
markdownMeasures: []
filters: []
titleSize: 14
title: ""
filterMode: DEFAULT
titleColor:
mode: AUTO
stateName: null
markdownText: ""
sorting:
- name: Quantity
value:
mode: IN_WIDGET
index: 1
group: dimensionsAndMeasures
direction: DESC
showTotal: false
actions: []
titleWeight: NORMAL
rowsLimit: 150
Was the article helpful?