Dashboard¶

Diese Seite beschreibt alle dashboard-weiten Konfigurationsobjekte.

DashboardConfig¶

DashboardMetaConfig¶

Hinweis:

• die App zeigt im Kopfbereich aktuell den Titel und direkt darunter eine kompakte Statuszeile
• diese Statuszeile enthält Datum + Uhrzeit der letzten Aktualisierung sowie Online oder die aktuelle Fehleranzahl
• subtitle bleibt aus Kompatibilitätsgründen im Schema erhalten, wird aber nicht separat angezeigt

DashboardLayoutConfig¶

Hinweis:

• die Spaltenzahl wird zur Laufzeit mindestens auf 1 begrenzt
• der Zellwert wird aus Bildschirmbreite, Spaltenzahl und spacingDp berechnet

DashboardGroupConfig¶

Validierungsregeln:

• id darf nicht leer sein
• widthColumns muss mindestens 1 sein, wenn gesetzt
• highlightColor muss ein gültiger Hex-Farbwert wie #RRGGBB oder #AARRGGBB sein, wenn gesetzt
• borderColor muss ein gültiger Hex-Farbwert wie #RRGGBB oder #AARRGGBB sein, wenn gesetzt
• widgetIds darf nicht leer sein
• valueWidgetId muss, wenn gesetzt, auf ein Widget innerhalb derselben Gruppe zeigen
• alle valueWidgetIds müssen, wenn gesetzt, auf Widgets innerhalb derselben Gruppe zeigen
• Widgets dürfen nicht in mehreren Gruppen auftauchen

Kompatibilität:

• das alte Feld maxWidthDp wird beim Einlesen weiterhin akzeptiert
• für neu Konfigurationen sollte widthColumns verwendet werden
• wenn borderColor fehlt, verwendet die App zuerst highlightColor und danach die globale Theme-Farbe groupHighlight
• bei expandable: true erscheint die Gruppe im Haupt-Dashboard immer als 1/1 Kachel; das Popup nutzt dieselbe Widgetgrösse wie das Haupt-Grid und höchstens fünf Spalten
• wenn valueWidgetId gesetzt ist, rendert die eingeklappte Kachel den bereits aufgelösten value dieses Widgets unter dem Gruppen-Icon
• wenn valuePattern gesetzt ist, rendert die eingeklappte Kachel dieses Template mit den aufgelösten value-Texten aus valueWidgetIds; Platzhalter verwenden dabei direkt die Widget-IDs

DashboardGroupIconConfig¶

DashboardTabConfig¶

Verhalten:

• wenn groupIds und widgetIds beide leer sind, zeigt der Tab automatisch alle ungruppierten Widgets und alle Gruppen
• Tabs werden nach order, danach nach title, danach nach id sortiert
• innerhalb eines Tabs darf ein Widget nicht gleichzeitig direkt und über eine Gruppe referenziert sein

DashboardDefaultsConfig¶

SharedStatusRequestConfig¶

Laufzeitverhalten:

• pro Aktualisierungszyklus wird jeder referenzierte Shared-Request genau einmal ausgeführt
• alle Widgets mit derselben sharedRequestId lesen anschliessend aus derselben Antwort

RequestDefaultsConfig¶

Merge-Regel:

• die finalen Header ergeben sich aus defaults.request.headers + request.headers
• falls kein Accept gesetzt ist, fügt die App automatisch application/json, image/png, image/jpeg hinzu

Beispiel¶

{
  "dashboard": {
    "title": "Mein Smart Home",
    "defaultTabId": "home",
    "layout": {
      "portraitColumns": 4,
      "landscapeColumns": 6,
      "spacingDp": 14,
      "contentPaddingDp": 16,
      "cornerRadiusDp": 26
    },
    "groups": [
      {
        "id": "living-room-controls",
        "title": "Wohnzimmer",
        "order": 14,
        "expandable": true,
        "icon": {
          "name": "light",
          "sizeDp": 28
        },
        "valueWidgetId": "living-room-light",
        "highlightColor": "#C88A43",
        "borderColor": "#8A4A17",
        "widgetIds": [
          "living-room-light",
          "living-room-dimmer"
        ]
      }
    ],
    "tabs": [
      {
        "id": "home",
        "title": "Zuhause",
        "order": 10,
        "groupIds": [
          "living-room-controls"
        ]
      }
    ]
  }
}

Siehe auch¶

• Tabs, Gruppen und Grid
• Status und Requests