Auswertungen & Dashboards
Überblick
Der Bereich beantwortet Fragen an die eigenen Daten. Vier Bausteine greifen ineinander:
- Auswertungen sind gespeicherte Fragen — Kennzahl, Zeitraum, Filter, Gruppierung.
- Dashboards stellen mehrere Auswertungen nebeneinander.
- Ziele legen einen Sollwert neben die Kennzahl, damit man Abweichung statt nur Höhe sieht.
- Zeitreihen halten Kennzahlwerte je Stichtag fest — die Grundlage für Verläufe.
Kennzahlen kommen aus den Modulen selbst; was nicht installiert ist, liefert auch keine Kennzahl.
Kernaufgaben
Eine Auswertung bauen. Sie wählen die Kennzahl, setzen Zeitraum und Filter und gruppieren. Das Ergebnis lässt sich speichern und weitergeben.
Ein Dashboard zusammenstellen. Kacheln werden angeordnet; ein Dashboard kann persönlich oder für eine Rolle geteilt sein.
Ziele hinterlegen. Ein Ziel gilt für einen Zeitraum und wird neben dem Ist gezeigt.
Berichte planen. Ein Zeitplan verschickt eine Auswertung regelmäßig — an Personen oder Rollen.
Felder im Detail
Der Bereich hat vier Masken: Bericht, Dashboard (mit dem Widget-Dialog), Zeitplan und KPI-Ziel. Jede schreibt auf eine eigene Ressource.
Bericht
Angelegt wird mit Name, Datensatz, Beschreibung und Sichtbarkeit; alles Weitere steht in der Konfiguration der Berichts-Detailseite.
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Name name | ja | Text, max. 200 Zeichen | Wie der Bericht in Liste, Zeitplan und Export heißt. |
Datensatz dataset | nein (Vorbelegung custom) | Schlüssel aus dem Datensatz-Katalog, max. 60 Zeichen | Der Quellbereich der Auswertung — z. B. Finanzen, Zeit & Auslastung, Vertrieb. Er bestimmt, welche Kennzahlen überhaupt zur Verfügung stehen. |
Beschreibung description | nein | Text, max. 1000 Zeichen | Wofür der Bericht gedacht ist. |
Kennzahlen (Measures) measures | ja | Liste von Kennzahl-Schlüsseln | Was gerechnet wird — die Spalten der Auswertung. Ohne mindestens eine Kennzahl lässt sich der Bericht nicht speichern. |
Dimensions-Kette dimensions | nein | Liste von Dimensions-Schlüsseln | Wonach aufgeteilt wird. Die erste Dimension ist die Zeilenachse, jede weitere eine Stufe im Aufbohren (Drill-down). Leer heißt: eine Summenzeile. |
Filter filters | nein | Schlüssel/Wert-Paare | Was einbezogen wird. Die Berichtsmaske pflegt sie nicht selbst — sie entstehen aus einer Vorlage oder werden über Schnittstelle und Automation gesetzt. |
Sortierfeld sortField | nein | Feldname, max. 60 Zeichen | Wonach das Ergebnis sortiert wird; leer = Standardsortierung. |
Sortierrichtung sortDir | nein | desc (absteigend) oder asc | In welche Richtung sortiert wird. |
Zeitraum dateRange | nein | this_month, last_month, this_quarter, this_year, ytd, last_12_months, custom | Welcher Zeitraum ausgewertet wird. Alles außer custom ist rollierend und hält den gespeicherten Bericht aktuell, ohne dass jemand nachzieht. |
Von customFrom | nein | Datum | Beginn des Zeitraums — nur bei dateRange: custom; bei jedem anderen Zeitraum wird die Angabe beim Speichern geleert. |
Bis customTo | nein | Datum | Ende des Zeitraums, dieselbe Bedingung. |
Granularität period | nein | day, week, month, quarter, year | In welchen Schritten der Zeitraum zerlegt wird. |
Vergleich comparison | nein | none, previous_period, previous_year | Ob eine Vergleichsspalte mitläuft und gegen welchen Zeitraum. |
Sichtbarkeit scope | nein | personal, role, shared | Wer den Bericht sieht. |
Marke brandFilter | nein | eine Ihrer Marken | Auf welche Marke sich der Bericht bezieht. Bei scope: personal wird das Feld beim Speichern geleert. |
Export starten erzeugt einen Lauf im Hintergrund; das gewählte Format (csv, xlsx, pdf) ist der einzige Wert dieses Dialogs und gehört zur Aktion, nicht zum Bericht.
Dashboard
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Name name | ja | Text, max. 200 Zeichen | Wie das Dashboard heißt. |
Sichtbarkeit scope | nein | personal, role, shared (max. 10 Zeichen) | Wer es sieht. Ein Rollen-Dashboard ist der Weg, allen Vertriebsmitarbeitern dieselbe Sicht zu geben, ohne sie zehnmal zu bauen. |
Rolle roleId | nein | bestehende Rolle | Für welche Rolle es gilt, wenn die Sichtbarkeit das verlangt. |
Marke brandFilter | nein | eine Ihrer Marken | Auf welche Marke sich die Kacheln beziehen. |
Als Standard-Dashboard isDefault | nein | Ja/Nein | Ob dieses Dashboard beim Öffnen des Bereichs zuerst erscheint. |
Kacheln widgets | nein | Liste von Kachel-Definitionen | Der gesamte Kachel-Satz. Ein Schreibvorgang ersetzt ihn vollständig — die Oberfläche sendet deshalb bei jeder Änderung alle Kacheln mit. |
Raster layout | nein | Raster-Angaben (Spalten/Positionen) | Der freie Rasterplatz der Kacheln auf der Startseite. Wird von der Startseite gepflegt, nicht in diesem Dialog. |
Der Kachel-Dialog schreibt kein eigenes Feld, sondern einen Eintrag in widgets:
| Schlüssel der Kachel | Werte / Format | Bedeutung |
|---|---|---|
| Widget-Typ | Schlüssel aus dem Widget-Katalog | Welche Art Kachel. Operative Kacheln bringen Inhalt und Größe selbst mit; dort ist nur der Titel wählbar. |
| Kennzahl | Kennzahl-Schlüssel | Was die Kachel zeigt. Bei nicht-operativen Kacheln Pflicht. |
| Titel | Text | Überschrift der Kachel; leer = Name der Kennzahl. |
| Dimension | global, brand, customer, project, employee, team | Wonach aufgeteilt wird. Nur bei Kacheltypen, die eine Dimension brauchen — dann Pflicht. team teilt nach dem Team am Mitarbeiter auf; wessen Rolle auf „nur eigenes Team" beschränkt ist, sieht nur die Zeilen seiner Teams — ebenso bei employee (Stamm-Team des Mitarbeiters) und owner (Teams des Nutzers); Personen ohne Team bleiben sichtbar. |
| Zeitraum | wie dateRange, jedoch ohne custom | Welcher Zeitraum. Ein eigener Zeitraum ist auf der Kachel nicht vorgesehen. |
| Granularität | day, week, month, quarter, year | In welchen Schritten. |
| Vergleich | none, previous_period, previous_year | Ob eine Vergleichszahl mitläuft. |
| Breite / Höhe | 1 oder 2 | Größe im Dialog-Raster. Bei operativen Kacheln bleibt die Größe des Startseiten-Rasters unangetastet. |
Zeitplan
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Bericht reportDefinitionUlid | ja | gespeicherter Bericht | Welche Auswertung versendet wird. |
Name name | nein | Text, max. 200 Zeichen | Wie der Zeitplan heißt; leer = Name des Berichts. |
Frequenz frequency | ja | daily, weekly, monthly | Wie oft der Lauf fällig wird. |
Format format | ja | csv, xlsx, pdf | In welchem Format exportiert wird. |
Empfänger recipients | ja | Liste aus E-Mail-Adressen oder Nutzer-ULIDs | Wer die Datei bekommt. Ohne Empfänger nimmt die Maske den Zeitplan nicht an. |
Aktiv active | nein | Ja/Nein | Aus pausiert den Zeitplan, ohne ihn zu löschen. |
KPI-Ziel
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Kennzahl metricKey | ja | Kennzahl-Schlüssel, max. 60 Zeichen | Wofür das Ziel gilt. |
Dimension dimensionKey | nein (Vorbelegung global) | global, brand, customer, project, employee, team, owner, channel, stage (max. 30 Zeichen) | Auf welcher Ebene das Ziel gilt; team macht es zum Team-Ziel. Ist Ihre Rolle auf „nur eigenes Team“ beschränkt, sehen und pflegen Sie Team- und Personen-Ziele nur für Ihre Teams — ein solches Ziel „für alle“ (leerer Wert) nur teamübergreifend. |
Dimensionswert dimensionValue | nein | Text, max. 60 Zeichen | Für welchen konkreten Wert der Dimension — leer heißt: für alle. Bei global ist das Feld gesperrt. |
Periode period | nein (Vorbelegung month) | day, week, month, quarter, year | Auf welchen Zeitabschnitt sich der Sollwert bezieht. |
Zielwert targetValue | ja | ganze Zahl in der kanonischen Einheit der Kennzahl | Der Sollwert. Die Einheit hängt an der Kennzahl: Geld in Cent (150000 = 1.500,00 €), Dauer in Minuten, Prozent in Basispunkten (8500 = 85,00 %), sonst Tage bzw. Anzahl. Die Maske blendet dafür das passende Eingabefeld ein und nennt die Einheit im Hinweis. |
Vergleich comparison | nein (Vorbelegung gte) | gte = erreichen oder übertreffen · lte = unterbieten | In welche Richtung das Ziel gilt. lte ist der Fall für Kennzahlen, bei denen klein gut ist — etwa Außenstandsdauer. |
Gültig ab validFrom | nein | Datum | Ab wann das Ziel greift; leer = ohne Anfang. |
Gültig bis validTo | nein | Datum | Bis wann; leer = ohne Ende. |
Marke brandId | nein | eine Ihrer Marken | Für welche Marke das Ziel gilt; leer = alle Marken. |
Sie sehen nur, was Sie sehen dürfen. Der Rechte-Schnitt liegt in der Auswertung selbst — dieselbe gespeicherte Auswertung kann bei zwei Personen verschiedene Zahlen liefern, ohne dass etwas kaputt ist. Ein Export gibt genau das aus, was am Bildschirm stand; er ist kein Weg an den Rechten vorbei.
Einstellungen & Rechte
- Dashboards:
reporting.dashboard.view/reporting.dashboard.manage - Auswertungen und Ziele:
reporting.report.view/reporting.report.manage - Finanzielle Kennzahlen (Umsatz, Marge, DSO, MRR):
reporting.kpi.financial - Personenbezogene Kennzahlen (Auslastung, Kostensätze):
reporting.kpi.hr - Exportieren und planen:
reporting.export· Markenübergreifend:reporting.brand.all
Die beiden Kennzahl-Rechte sind eigenständig, weil ihr Inhalt es ist: Wer Projekte auswerten darf, darf deswegen noch keine Gehaltskostensätze sehen.
Rollen mit der Option „nur eigenes Team“ sehen auf Team- und Personen-Achsen nur ihr Team — und auch die Gesamtsumme und die Summe je Marke bilden für sie nur die Personen, die sie sehen (eigenes Team, Personen ohne Team). Das gilt für Kennzahlen, Verläufe, gespeicherte Auswertungen und Dashboard-Kacheln; sonst ließe sich ein fremdes Team als Summe minus eigenes Team herausrechnen. Kennzahlen ohne Personen- oder Team-Bezug bleiben unverändert.
Modul-Flag: module.reporting.
FAQ & Fehlerbilder
Eine Kennzahl fehlt in der Auswahl. Dann ist das liefernde Modul nicht aktiv, oder Ihnen fehlt das Kennzahl-Recht.
Zwei Personen sehen unterschiedliche Zahlen. Das ist richtig: Auswertungen laufen im Rechte- und Marken-Schnitt des Betrachters.
Ein geplanter Bericht kam nicht an. Prüfen Sie Zeitplan und Empfänger. Geplante Berichte laufen im Namen und mit den Rechten des Berichtsinhabers: Fehlt der Inhaber, ist er deaktiviert oder fehlt ihm das Export- oder Leserecht, entsteht kein Export — der Lauf steht mit dem Grund bei den Export-Läufen.