Überblick

Ein Bericht in Flexie ist eine gespeicherte Abfrage plus eine Darstellung. Wenn jemand ihn öffnet, führt Flexie die Abfrage aus, wendet alle vom Nutzer angegebenen Filter an und zeigt das Ergebnis in einer von zwei Formen: als Datengitter (eine sortierbare, filterbare und exportierbare Tabelle) oder als vollständig eigene HTML-Seite, die Sie selbst geschrieben haben.

Was aus einem Bericht wird

Ein einziger Bericht lässt sich verwenden als:

• Eine operative Liste („alle Deals, die diesen Monat abschließen")
• Eine aggregierte Kennzahl („Umsatz pro Vertriebler, letzte 90 Tage")
• Eine datensatzübergreifende Zusammenfassung („Top-Firmen nach Ticket-Volumen")
• Ein maßgeschneidertes Dashboard-auf-einer-Seite (ein HTML-Bericht kann alles, was HTML kann)
• Eine Datenquelle für Dashboard-Widgets
• Eine Datenquelle für Skripte und Workflows

Es gibt kein separates BI-Tool zu lernen; Berichte leben neben allem anderen.

Die zwei Ausgabeformate

Wenn Sie einen Bericht erstellen, wählen Sie eines von zwei Ausgabeformaten. Das ist die zentrale Entscheidung und verändert sowohl das, was Sie schreiben, als auch das, was der Bericht kann.

Ausgabeformat	Was Sie schreiben	Was dargestellt wird	Wann Sie es verwenden
Datengitter (Standard)	Eine SELECT-Abfrage	Eine sortierbare, filterbare, paginierte Tabelle	Listen, Exporte, alles Tabellarische
HTML	HTML + CSS + JavaScript mit Flexie Scripting	Was immer Sie geschrieben haben, dargestellt als Seite	Vollständig eigene Layouts: Karten, Dashboards, Kanban-Boards, alles, was sich mit Web-Technologie bauen lässt

Sie können in Ihrem Account mischen: manche Berichte sind Gitter, andere vollständig maßgeschneiderte HTML-Seiten. Sie werden in derselben Tabelle gespeichert und gemeinsam aufgelistet.

Das Ausgabeformat ist für die gesamte Lebensdauer des Berichts festgelegt. Existiert ein Bericht erst einmal als Gitter, können Sie ihn nicht auf HTML umstellen; legen Sie einen neuen Bericht an, wenn Sie wechseln müssen.

Was jeder Bericht hat

Ob Gitter oder HTML, jeder Bericht hat:

• Name, Beschreibung, Kategorie, um ihn später wiederzufinden.
• Ausgabeformat, Data Grid oder HTML.
• Den Body, Ihre Abfrage (beim Gitter) oder Ihr Template (bei HTML).
• Filter, optionale Eingabesteuerungen, die über dem Bericht angezeigt werden, wenn jemand ihn öffnet. Siehe Berichtsfilter (im Detail).
• Standardsortierung, nach welcher Spalte sortiert wird, aufsteigend oder absteigend.
• Zugriffsliste, wer ihn sehen darf. Kombinationen aus „alle Nutzer", bestimmten Rechten, Gruppen oder einzelnen Nutzern.
• Eigentümer, der Nutzer, der ihn erstellt hat (relevant für Rechteprüfungen).

Der Lebenszyklus eines Berichts

1. Erstellen unter /reports/new, indem Sie eine Abfrage oder ein HTML-Template schreiben.
2. Öffnen unter /reports/view/{id}. Sortieren, filtern, paginieren, als CSV exportieren.
3. Verfeinern der Filter, Sortierung und Spalten und speichern.
4. Wiederverwenden als Dashboard-Widget oder per Skript abfragen.

Die Daten werden bei jedem Öffnen aktualisiert, es gibt also keine Überraschung durch veralteten Cache. Schwere Abfragen sind durch ein hartes Limit von 1.000 Zeilen geschützt (siehe Einschränkungen).

Was in diesem Abschnitt steht

1. Datengitter-Berichte: das Schreiben des SELECT, die Platzhaltervariablen, die Flexie für Sie einsetzt ({user_id}, {group_id}, {role_id}, {timezone}), die {filters}-Substitution, welche Abfragen erlaubt sind und welche blockiert werden, die Standardsortierung und die Spaltenanordnung zur Anzeigezeit.
2. HTML-Berichte: das Bauen eines vollständig eigenen Berichts aus HTML + CSS + JavaScript mit Flexie Scripting; die Nutzung des vollen Flexie-Scripting-Werkzeugkastens im Template; das Aufrufen mehrerer Datenabfragen und das Verweben der Ergebnisse; das Sicherheitsmodell.
3. Anzeigen, Exportieren & Zugriff: die Ansichtsseite, Sortierung und Paginierung, CSV-Export und das Rechtemodell „Wer kann auf diesen Bericht zugreifen?".
4. Berichte in Workflows und Dashboards: die Nutzung eines gespeicherten Berichts als Dashboard-Widget (mit sechs Visualisierungs-Subtypen), das Abrufen seiner Daten aus einem Flexie-Scripting-Kontext und der Accessor getReportData(...).
5. Berichtsfilter (im Detail): Eingabefilter über dem Gitter. Die JSON-Struktur, die sechs Filtertypen und ihre Operatoren, die drei Substitutionsmodi ({filters}-Platzhalter, automatisch und manual) und, ganz besonders, die Nutzung von Flexie Scripting innerhalb des Filter-JSON, um dynamische Optionslisten, bedingte Filter und datumsbewusste Bezeichnungen zu bauen.

Eng verwandt

• Dashboards: Sammlungen von Widgets, wo die meisten Berichte am Ende angezeigt werden.
• Flexie Scripting: die Sprache, die Sie in HTML-Berichten verwenden.
• Workflows: Workflows können Werte aus gespeicherten Berichten ziehen.