# Andon board card

> Canonical HTML: https://screenrig.ai/docs/cards/andon/

A factory-floor andon board: every production line as a big tile in its status colour (running, warning, stopped, idle or changeover) with the reason, how long it has held and a strip of its stations. Lines come from the factory integration.

Category: Operations. Tags: Alerts and status, Factories and warehouses, Numbers and metrics.

## Previews

![Andon board](/cards/andon/v1/screenshots/canvas-bloom.webp?sha=97aca717881498cbe45ce38c45a06e84929e0c1f33942ae787a8c63adbb41515)

Canvas

![Andon board](/cards/andon/v1/screenshots/corner-bloom.webp?sha=8325a85dcf1785e33e038e2eaa2e1de7c2808d962f06ee2a77aae8ed47d6e5da)

Corner

![Andon board](/cards/andon/v1/screenshots/chip-bloom.webp?sha=298d820c48db6a6cd2506eb1d658fc534d94ba4aedaf4233b26b73f8f40c4c42)

Chip

## Views and forms

Views: canvas, corner, chip. Canvas forms: landscape, portrait, square, strip.

[Card views, themes and publishing](/docs/cards/). [Browse the gallery](/apps/#cards).

## Data and privacy

This card uses its configured properties and live card data.

## Properties

For theme, background, accent and position, see [Common properties](/docs/cards/#common-properties).

Set static properties in `params`. Bind `data` to a project card data key for live values; that document holds only dynamic properties. Without a data key, put the complete configuration in `params`. Nested rows describe the contents of their parent property.

### Static properties

| Name | Type | Default | Values and limits | Description |
| --- | --- | --- | --- | --- |
| `title` | string | `""` | maxLength: `40` | Empty uses Production floor. |
| `order` | string | `"listed"` | `"listed"`, `"attention"` | Attention puts stopped lines first, then warning, changeover, idle and running. |
| `showClock` | boolean | `true` |  |  |
| `hour12` | boolean | `false` |  |  |
| `timeZone` | string, null | `null` |  |  |

### Dynamic properties

| Name | Type | Default | Values and limits | Description |
| --- | --- | --- | --- | --- |
| `lines` | array | `[]` | minItems: `0`; maxItems: `8` |  |
| `lines[].name` | string |  | minLength: `1`; maxLength: `40`; Required |  |
| `lines[].status` | string | `""` | maxLength: `20` | running, warning, stopped, idle or changeover. Left out, it comes from the stations: stopped, then warning, then changeover, then running, else idle. Also read: run, ok, active, normal, producing; warn, attention; stop, down, fault, error, e-stop, halted; paused, standby, off, offline; setup. Any other word reads as a warning. |
| `lines[].reason` | string | `""` | maxLength: `80` | Why the line is in this status. Left out, the first station in the same status supplies it. |
| `lines[].since` | string | `""` | maxLength: `32` | When the line entered this status (ISO 8601 with an offset). Left out, the first station in the same status supplies it. |
| `lines[].stations` | array | `[]` | maxItems: `12` |  |
| `lines[].stations[].name` | string |  | minLength: `1`; maxLength: `30`; Required |  |
| `lines[].stations[].status` | string | `""` | maxLength: `20` |  |
| `lines[].stations[].reason` | string | `""` | maxLength: `80` |  |
| `lines[].stations[].since` | string | `""` | maxLength: `32` |  |
| `footnote` | string | `""` | maxLength: `120` | A shift or plant note along the foot. |

## Canvas example

Add this item to a playlist page’s `primitives`. [Publish the playlist and assign a screen](/docs/cards/#publish-a-card-canvas).

```json
{
  "id": "andon",
  "primitive": "card",
  "card": "andon",
  "major": 1,
  "params": {
    "theme": "neomustard"
  },
  "rect": {
    "x": 0,
    "y": 0,
    "width": 1920,
    "height": 1080
  },
  "layer": 0,
  "content_fit": "fill",
  "data": "andon-main"
}
```

## Write live data

Create this document before showing the card, then replace it to update the screen without republishing. Use the same project as the playlist. Supply your API authorization through the environment; see [API authentication](/docs/authentication/).

```console
curl --request PUT "https://api.screenrig.ai/api/card-data/andon-main" \
  --header "Authorization: Bearer $SCREENRIG_TOKEN" \
  --header "ScreenRig-Project: $SCREENRIG_PROJECT" \
  --header "Content-Type: application/json" \
  --data '{"document":{"lines":[],"footnote":""}}'
```