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 in the view 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 | Title 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
widgets:
- key: table (1)
apiVersion: "17"
type: TABLE
settings:
titleColor:
mode: AUTO
titleSize: 14
paddings: 8
titleWeight: NORMAL
textSize: 12
filterMode: DEFAULT
ignoreFilters: false
stateName: null
title: ""
showMarkdown: false
markdownMeasures: []
markdownText: Description
verticalAlign: TOP
rowsLimit: 15
dimensionsAndMeasures:
- type: DIMENSION
name: Application Number
value:
mode: FORMULA
formula: '"case_table"."case_id"'
dbDataType: String
formatting:
value: AUTO
mode: BASE
hideEmptyValues: false
format:
value: STRING
mode: BASE
onClick: []
displayCondition:
mode: DISABLED
width:
value: null
mode: PIXEL
displayMode: NONE
- type: DIMENSION
name: Service Type
value:
mode: FORMULA
formula: '"case_table"."dir_services_def"'
dbDataType: String
formatting:
value: AUTO
mode: BASE
hideEmptyValues: false
format:
value: STRING
mode: BASE
onClick: []
displayCondition:
mode: DISABLED
width:
value: null
mode: PIXEL
displayMode: NONE
- type: DIMENSION
name: Communication Channel
value:
mode: FORMULA
formula: '"case_table"."intr_type"'
dbDataType: String
formatting:
value: AUTO
mode: BASE
hideEmptyValues: false
format:
value: STRING
mode: BASE
onClick: []
displayCondition:
mode: DISABLED
width:
value: null
mode: PIXEL
displayMode: NONE
- type: DIMENSION
name: Start Time
value:
mode: FORMULA
formula: '"case_table"."start"'
dbDataType: String
formatting:
value: AUTO
mode: BASE
hideEmptyValues: false
format:
value: STRING
mode: BASE
onClick: []
displayCondition:
mode: DISABLED
width:
value: null
mode: PIXEL
displayMode: NONE
- type: DIMENSION
name: Completion Time
value:
mode: FORMULA
formula: '"case_table"."finish"'
dbDataType: String
formatting:
value: AUTO
mode: BASE
hideEmptyValues: false
format:
value: STRING
mode: BASE
onClick: []
displayCondition:
mode: DISABLED
width:
value: null
mode: PIXEL
displayMode: NONE
- type: MEASURE
name: Top user_name
value:
outerAggregation: count
mode: AGGREGATION
templateName: top
processKey: null
caseCaseIdFormula: null
eventName: null
eventNameFormula: null
filters: []
tableName: UserInfo
columnName: user_name
eventTimeFormula: null
dbDataType: UInt64
displayMode: NONE
displayCondition:
mode: DISABLED
width:
value: null
mode: PIXEL
format:
value: NUMBER
mode: BASE
formatting:
value: AUTO
mode: BASE
filters: []
showTotal: false
markdownTextSize: 26
headColor:
mode: BASE
value: "#222F3E"
headWeight: BOLD
headTextColor:
mode: AUTO
totalTextColor:
mode: AUTO
totalWeight: BOLD
totalColor:
mode: AUTO
actionButtons: []
localApiVersion: "2"
Was the article helpful?