Skip to content

DataGrid Flow

This flow covers the 6 steps for the Table widget, which displays data in tabular format. Unlike Cartesian/Circular flows, Step 4 Data Configuration, Step 5 Series Design, and Step 6 Add Series are skipped. After selecting a Compass record, the flow jumps directly to Step 7 General Design, where column visibility, order, and styling are configured.

Chart Types Using This Flow

Chart Type Primary Use Page
Table Multi-column sortable/filterable data table Table

Comparison with Other Group Flows

DataGrid covers a single chart type. There is no X/Y axis mapping, no series concept, and no series addition — all query columns are automatically added to the table and managed in Step 7.


Flow Diagram

flowchart LR
    A[1. Group<br/>DataGrid] --> B[2. Chart Type<br/>Table]
    B --> C[3. Compass Record]
    C --> G[7. General Design<br/>Column Config]
    G --> H[8. Card Design]
    H --> I[9. Display Info]

Step Pages

This flow runs 6 of the wizard steps (4, 5, and 6 are not present):

# Step Page Key Content
1 Group Selection 01 — Group Selection Select the DataGrid card
2 Chart Type Selection 02 — Chart Type Table card
3 Compass Record Selection 03 — Compass Record Any query structure (columns are automatically added to the table)
7 General Design — Column Config 07 — General Design Column visibility/order, header/row style, sorting, filtering, conditional row color
8 Card Design 08 — Card Design Refresh, Border, Info Card
9 Display Information 09 — Display Info Name, Tags, Folder

Steps Not in This Flow

Skipped Step Purpose in the standard flow Why it isn't needed here
4 — Data Configuration X/Y axis mapping, Stack By / Low/High mapping The table has no axes; all query columns are automatically added to the table
5 — Series Design Series color, marker, data label visual settings There is no series concept in a table; visual settings (column width, header style, row color) are in Step 7
6 — Add Series Add a second/third series to the chart The table uses a single Compass record

Data Requirements

The query can have any column structure; the number and type of columns are not restricted. All columns are managed in Step 7 for visibility and ordering.

-- Example: latest sensor readings
SELECT ts, machine_name, temperature, pressure, status
FROM sensor_log
ORDER BY ts DESC
LIMIT 50;
-- Example: active alarm list
SELECT alarm_time, machine, description, level
FROM alarms
WHERE active = true
ORDER BY alarm_time DESC;

Column Count

For queries with many columns (10+), hide non-essential columns in Step 7. Bring 4–6 critical columns that an operator needs to see at a glance to the front.


Next Step

01 — Group Selection