---
title: "Dashboards"
description: "Berichte und Diagramme. Jede App ist ein Modul auf einem gemeinsamen Datenmodell."
canonical: "https://obop.dev/de/apps/dashboards/"
lang: "de"
---

# Dashboards

## Wofür sie gedacht ist

Store dashboards and widgets as data (KPI, bar, line, pie and table definitions) for a client to render. The package never runs a query and does not check that the models it names exist.

## Was das Paket leistet und was nicht

Dashboards and their widgets stored as data, for a UI to render. A dashboard has a title and an owner and is private to them (and to dashboards.manager) unless it is shared; its tiles follow it. A widget describes one tile with these fields: kind (kpi, bar, line, pie or table), model_name (the model to read, for example sale_order), measure_field (the field to aggregate; empty for count), aggregate (count or sum; sum needs a number or money measure_field), group_by (field to split by, for bar, line, pie and table; empty for a single kpi value), filter (a JSON object of field names to exact values, for example {"state":"paid"}; empty means all records) and position (order on the dashboard, lowest first). The package only stores the definition; it does not check that the model or fields exist and it computes nothing.

## Moduldetails

- **Version:** `0.3.0`
- **Autor:** SpaceCorps
- **Lizenz:** [AGPL-3.0-or-later](https://spdx.org/licenses/AGPL-3.0-or-later.html)
- **Benötigt Kern:** `^0.2` (aktuell ist Kern 0.2.0)
- **Reifegrad:** Experimentell
- **Kategorien:** Produktivität

## Modelle

### `dashboards_dashboard`

A dashboard: a titled, ordered collection of widgets

Lesegruppe: `dashboards.user`. Schreibgruppe: `dashboards.manager`.

| Feld | Art | Datenklasse | Personenbezogene Daten | Gruppe | Agenten sehen | Beschreibung |
|---|---|---|---|---|---|---|
| `title` | text | `none` | nein | `dashboards.user` | im Klartext | Dashboard title, for example Sales overview |
| `owner` | text | `internal` | ja | `dashboards.user` | maskiert | User name of the person who owns the dashboard; the person who creates it unless set otherwise |
| `description` | longtext | `none` | nein | `dashboards.user` | im Klartext | What the dashboard shows and for whom |
| `shared` | bool | `none` | nein | `dashboards.user` | im Klartext | Whether everyone who may read dashboards sees it (and its tiles), or only the owner and dashboards.manager; the server enforces it |
| `position` | number | `none` | nein | `dashboards.user` | im Klartext | Order among dashboards, lowest first |

### `dashboards_widget`

One tile on a dashboard, defined by what to read and how to aggregate it

Lesegruppe: `dashboards.user`. Schreibgruppe: `dashboards.manager`.

| Feld | Art | Datenklasse | Personenbezogene Daten | Gruppe | Agenten sehen | Beschreibung |
|---|---|---|---|---|---|---|
| `dashboard_id` | ref → dashboards_dashboard | `none` | nein | `dashboards.user` | im Klartext | The dashboard the widget is on |
| `title` | text | `none` | nein | `dashboards.user` | im Klartext | Tile title, for example Paid orders |
| `kind` | select (kpi, bar, line, pie, table) | `none` | nein | `dashboards.user` | im Klartext | How the tile is drawn: kpi, bar, line, pie, table |
| `model_name` | text | `none` | nein | `dashboards.user` | im Klartext | Model the tile reads, for example sale_order |
| `measure_field` | text | `none` | nein | `dashboards.user` | im Klartext | Field to aggregate: a number or money field of the model; empty when counting |
| `aggregate` | select (count, sum) | `none` | nein | `dashboards.user` | im Klartext | How records are combined: count or sum |
| `group_by` | text | `none` | nein | `dashboards.user` | im Klartext | Field to split the result by (a select, ref or date field); empty for one value |
| `filter` | longtext | `none` | nein | `dashboards.user` | im Klartext | JSON object of field names to exact values that records must match, for example {"state":"paid"}; empty means all records |
| `position` | number | `none` | nein | `dashboards.user` | im Klartext | Order of the tile on the dashboard, lowest first |

## Workflows

Diese App hat keine Workflow-Aktionen; Datensätze werden direkt angelegt und bearbeitet.

## Berechtigungsgruppen

Von dieser App verwendete Gruppen:

- `dashboards.manager`
- `dashboards.user`

## Freigabeschritte

Kein Schritt dieser App braucht eine Freigabe, abgesehen vom Löschen von Datensätzen.

## Was Agenten tun können und was nicht

Ein Agent kann Datensätze dieser App lesen, durchsuchen, anlegen und aktualisieren sowie Aktionen ausführen, die keine Freigabe brauchen, und zwar innerhalb der Berechtigungsgruppen seines Tokens.

Diese Schritte kann er nur vorschlagen, und eine Person muss sie freigeben: `dashboards_dashboard.delete`, `dashboards_widget.delete`.

Personenbezogene Daten werden als Platzhalter maskiert: `dashboards_dashboard.owner`.

## Abhängigkeiten

Keine.

## Installation

Installieren Sie sie in der App Customize (Marktplatz) oder über die Kommandozeile:

```bash
obop modules install-from dashboards
```

Erfordert eine Datenbank und Administratorrechte.

## Selbst bauen

[Der Modulleitfaden zeigt, wie Apps wie diese geschrieben werden](/de/docs/reference/module-manifest/)