RAG Grid Component
The RAG grid component renders a multi-row, multi-column matrix where each cell contains a RAG (Red/Amber/Green) status indicator. Use it to show the overall health of multiple areas in a single compact view — a project health dashboard at the start of an executive report.
When to use​
- Project health dashboard: rows = reporting areas (Schedule, Cost, Safety, Quality, Risk), columns = current period and prior period.
- Programme roll-up: rows = sub-projects or workstreams, columns = status categories.
- Discipline status: rows = engineering disciplines, column = current RAG.
Adding the component​
- Open the report output in the Output Designer.
- Click + Insert → RAG Grid.
- Position and resize the component.
- Configure rows and columns in the Data tab.
Structure​
The RAG grid is configured as a set of rows and columns:
Rows​
Each row corresponds to one reporting area or category. Rows can be:
| Row source | Description |
|---|---|
| Static rows | Manually define row labels (e.g. "Schedule", "Cost", "Safety"). |
| Dynamic rows | Rows driven by a repeating-row section (one row per blueprint row). |
Columns​
Each column maps to a specific field:
| Property | Description |
|---|---|
| Column header | Label shown at the top of the column. |
| Field | The blueprint field to read for each cell's RAG value. |
| Column width | Fixed width in pixels or auto. |
Cell options​
| Property | Options |
|---|---|
| Indicator style | Filled circle (default), square chip, pill badge. |
| Show label | Show the RAG label text beside the indicator (R / A / G, or custom labels from the blueprint). |
| Trend arrow | Show an up/down/flat arrow comparing current vs prior period value. |
| Tooltip | On hover, show the comment or narrative field linked to this RAG field. |
Label column​
The leftmost column shows the row label. Configure:
| Property | Description |
|---|---|
| Label field | For dynamic rows, the field to use as the row label. |
| Label width | Fixed width in pixels. |
| Icon | Optional icon beside the row label. |
Conditional row styling​
Highlight entire rows based on the value of a specific column:
| Condition | Effect |
|---|---|
| Any cell = Red | Bold row label and red left border. |
| Change from prior period | Background highlight on changed cells. |
Export behaviour​
- PDF / Word: Renders as an HTML table with coloured circle cells. Colours are preserved.
- Excel: Each cell exports as a text value (R / A / G) with conditional cell background fill (red/amber/green).