Mit der Berichtsfunktion lassen sich unterschiedliche Auswertungen in einem einfach teilbaren Dokument zusammenführen und durch erläuternde Texte ergänzen. Die Berichtsfunktion eignet sich zum Erstellen von Dashboards, zur Erfüllung von Berichtspflichten und als flexible Ad-hoc-Zusammenfassung wichtiger Datenpunkte für Entscheidungsträger.

Berichte nutzen

Mit der Berichtsfunktion können Sie:

• mehrere Auswertungen in einer Ansicht kombinieren

• schriftlichen Kontext zu Ihren Visualisierungen, einschließlich Karten, erstellen

• Fragestellungen über mehrere Themen oder Datensätze hinweg beantworten

• strukturierte Berichte mit anderen Nutzenden teilen

Berichte können Titel, Abschnitte, Kommentare und Auswertungen enthalten.

Berichte strukturieren

Berichte sind wie ein Word-Dokumente strukturiert. Sie können:

• mit Formatierung hinzufügen (fett, kursiv, Listen, Links usw.)

• in Texten einfügen für dynamische Werte ($variable_name)

• über Ihre gespeicherten Auswertungen einfügen

• Inhalte in durch ein flexibles Layout anordnen

Berichte erstellen

1. Gehen Sie zu Startseite → Arbeitsbereich → Lösung → Berichte

2. Klicken Sie auf Neuen Bericht erstellen

3. Legen Sie einen Titel und eine Beschreibung (optional) fest

4. Beginnen Sie mit dem Hinzufügen von Blöcken:

Es gibt keine Begrenzung für die Anzahl der Blöcke oder Abschnitte. Sie können diese jederzeit verschieben, entfernen oder duplizieren.

Hier geht es zur detaillierten Anleitung: .

Berichte speichern, teilen und exportieren

Sie können:

• Berichte speichern, um später daran weiterzuarbeiten

• Berichte über Links mit anderen Benutzern in Ihrer Organisation teilen

• Berichte als PDF-Datei exportieren, um sie außerhalb der Plattform zu teilen oder zu drucken

Nur Berichtsersteller (Eigentümer) und Berichtseditoren können Änderungen vornehmen. Betrachter können den Bericht nur ansehen.

Weitere Details finden Sie unter .

Berechtigungen

Schritt-für-Schritt-Anleitung

Eine Berichtsansicht zu erstellen ist wie eine individuelle Playlist aus Ihrer Musiksammlung zu machen - Sie wählen aus, welche Lieder (Inhalte) Sie einschließen und wie Sie sie für eine spezifische Zielgruppe organisieren.

Bevor Sie anfangen

Sie benötigen:

• Einen Bericht mit Seiten-, Gruppen- und Abschnitts-Struktur

• Eigentümer- oder Bearbeiterberechtigungen für den Bericht

• Eine klare Vorstellung davon, welche spezifischen Inhalte Sie zeigen möchten

Schritt-für-Schritt-Anleitung

Bewährte Praktiken

Inhaltsauswahl

• Fangen Sie breit an, dann verengen Sie: Schließen Sie zuerst ganze Gruppen ein, dann entfernen Sie spezifische Seiten, falls nötig

• Denken Sie an Ihre Zielgruppe: Welche Informationen benötigt diese spezifische Gruppe?

• Testen Sie den Ablauf: Stellen Sie sicher, dass die ausgewählten Inhalte eine kohärente Geschichte erzählen

• Berücksichtigen Sie die Navigation: Stellen Sie sicher, dass Benutzer finden können, wonach sie suchen

Benennung und Organisation

• Verwenden Sie beschreibende Namen: "Q4 Haushalt - Gemeinderat" ist besser als "Haushalts-Ansicht 2"

• Seien Sie konsistent: Verwenden Sie ähnliche Benennungsmuster für verwandte Ansichten

• Berücksichtigen Sie die Sortierung: Ansichten erscheinen in Listen, also denken Sie an die alphabetische Reihenfolge

Teilungsstrategie

• Passen Sie Berechtigungen an Inhalte an: Teilen Sie keine sensiblen Daten mit breiten Gruppen

• Nutzen Sie Organisationsgruppen: Effizienter als individuelle E-Mail-Adressen

• Dokumentieren Sie Ihre Ansichten: Behalten Sie den Überblick darüber, was jede Ansicht enthält und wer Zugriff hat

Stellen Sie sich Berichtsansichten wie verschiedene Wege vor, ein und dasselbe Fotoalbum zu betrachten. Sie haben ein Hauptalbum (den Bericht), aber Sie können verschiedene Ansichten erstellen, die nur bestimmte Fotos zeigen oder sie für verschiedene Personen anders organisieren.

Was Berichtsansichten sind

Berichtsansichten ermöglichen es Ihnen, angepasste Versionen Ihrer Berichte zu erstellen mit:

• Verschiedenen Seitenauswahlen - Zeigen Sie nur bestimmte Teile Ihres Berichts

• Vereinfachtem Teilen - Geben Sie Personen Zugriff ohne vollständige Berichtsberechtigung

• Mehreren Perspektiven - Derselbe Bericht, verschiedene Schwerpunkte für verschiedene Zielgruppen

• Zugriff nur zum Ansehen, nicht zum Bearbeiten - Personen können die Ansicht sehen, aber nicht den ursprünglichen Bericht bearbeiten

Praxisbeispiel: Der Haushaltsplan Ihrer Gemeinde könnte eine Ansicht für Abteilungsleiter haben (zeigt alle Abteilungen) und eine andere Ansicht für den Gemeinderat (zeigt nur Gesamtsummen und wichtige Highlights).

Ansichten vs. Berichte: Was ist der Unterschied?

Wann Berichtsansichten verwendet werden sollten

Wie Ansichten funktionieren

Die Beziehung

1. Sie erstellen einen Bericht mit all Ihren Daten, Diagrammen und Analysen

2. Sie erstellen Ansichten aus diesem Bericht mit spezifischen Seitenauswahlen oder Konfigurationen

3. Sie teilen die Ansichts-Links anstelle des vollständigen Berichts

4. Betrachter sehen nur das, was die Ansicht zu zeigen konfiguriert ist

Berechtigungsstruktur

• Berichtsberechtigungen: Kontrollieren, wer den ursprünglichen Bericht bearbeiten kann

• Ansichtsberechtigungen: Kontrollieren, wer jede spezifische Ansicht sehen kann

• Ansichtszugriff: Immer schreibgeschützt, unabhängig von Berichtsberechtigungen

• Ansichtsverwaltung: Nur Berichtseigentümer und -bearbeiter können Ansichten erstellen, bearbeiten und verwalten

Erste Schritte mit Ansichten

Bereit, Ihre erste Berichtsansicht zu erstellen? Hier ist, was Sie tun können:

• - Richten Sie Seitenauswahlen ein und teilen Sie sie mit anderen

• - Bearbeiten, organisieren und pflegen Sie Ihre Ansichten

Das Verwalten Ihrer Berichtsansichten ist wie die Pflege einer Bibliothek - Sie müssen die Dinge organisiert halten, Inhalte bei Bedarf aktualisieren und gelegentlich aufräumen, was nicht mehr nützlich ist.

Ihre Ansichten finden

Als Ansichtsersteller/-bearbeiter

Zugriff auf Ansichten vom Berichtseditor:

1. Öffnen Sie Ihren Bericht im Builder

2. Klicken Sie auf "Ansichten" in der oberen Navigation

3. Sie sehen alle Ansichten, die aus diesem Bericht erstellt wurden

Als Ansichtsbetrachter

Ansichten erscheinen unter Berichte:

1. Gehen Sie zu Berichte in der Hauptnavigation

2. Ansichten, auf die Sie Zugriff haben, erscheinen in der Berichtsliste

3. Sie zeigen sich mit dem Namen des ursprünglichen Berichts, auf dem sie basieren

4. Sie können sie als Ansichten identifizieren, wenn Sie sie öffnen (sie zeigen teilweise Inhalte)

Ansichtsverwaltung

Neben der globalen Filterleiste können Sie Filter jetzt als eigenständige Komponenten direkt im Bericht einfügen. Das ist besonders hilfreich, wenn Filter kontextnah neben Texten, KPIs oder Dashboard-Abschnitten erscheinen sollen.

Filter einfügen

1. Öffnen Sie den Bericht im Bearbeitungsmodus.

2. Klicken Sie in der Werkzeugleiste auf + Block → Filter.

3. Wählen Sie im Dialog den gewünschten Filter aus (nur Filter, die in der globalen Leiste sichtbar sind, stehen zur Auswahl).

4. Der Filter erscheint als Block auf der Seite und kann wie andere Elemente verschoben oder in Spalten angeordnet werden.

💡 Wenn kein Filter verfügbar ist, können Sie zunächst einen Filter im Filter-Panel anlegen oder dessen Sichtbarkeit aktivieren.

Verhalten von Filter-Komponenten

• Änderungen wirken sich – genau wie bei der Filterleiste – auf alle verbundenen Visualisierungen aus.

• Die komponentenbasierte Darstellung zeigt dieselben Optionen wie im Panel (z. B. Dropdown, Mehrfachauswahl, Datumskontrolle).

• Bei Dropdown-Filtern mit SQL-Optionen werden die Werte live vom Backend geladen.

Gestaltungstipps

• Platzieren Sie Filter-Komponenten am Anfang von Berichtskapiteln, damit Leser:innen den Kontext direkt beeinflussen können.

• Nutzen Sie Spaltengitter oder Karten, um Filter gemeinsam mit KPI-Kacheln oder erklärendem Text zu gruppieren.

• Für sehr viele Filter empfiehlt es sich, nur die wichtigsten als Komponente einzublenden und den Rest in der globalen Leiste zu lassen.

Kombinieren Sie Filter-Komponenten mit der Funktion , wenn alle Visualisierungen konsistent bleiben sollen.

Neben Typ und Eingabeoptionen bieten Berichtsfilter zusätzliche Schalter, mit denen Sie das Verhalten für Endnutzer:innen feinjustieren können. Die Einstellungen finden Sie im Tab Einstellungen der Filterkonfiguration.

Standardwert festlegen

Aktivieren Sie Standardwert, um einen Startwert für den Filter zu definieren. Dieser wird automatisch gesetzt, sobald jemand den Bericht öffnet.

Sobald ein Bericht erstellt wurde, kann er über die Speichern-Schaltfläche oder das ...-Menü in der oberen rechten Ecke des Editors verwaltet werden. Verfügbare Aktionen umfassen das Speichern von Änderungen, das Teilen mit anderen in Ihrer Lösung oder das dauerhafte Löschen des Berichts.

Verfügbare Optionen

Hinweise zu Sichtbarkeit und Berechtigungen

• Berichte sind für alle Benutzer in derselben Lösung sichtbar, aber Auswertungen, die zum Bericht hinzugefügt wurden, können nur angezeigt werden, wenn der aktuelle Betrachter des Berichts auch Editor- oder Eigentümerberechtigungen für die zugrundeliegenden Datensätze der Auswertungen hat

• Nur der Berichtseigentümer kann den Bericht löschen

• Berichtseditoren können den Bericht bearbeiten und die Änderungen speichern

Berichte exportieren

Exportieren Sie Ihre Berichte als PDF für Präsentationen, Archivierung oder zum Teilen außerhalb der Plattform.

Wie man einen Bericht exportiert

1. Öffnen Sie den gewünschten Bericht

2. Klicken Sie auf das ...-Menü in der oberen rechten Ecke

3. Wählen Sie Als PDF exportieren

4. Warten Sie, während der Bericht generiert wird

Was wird exportiert?

Der PDF-Export enthält:

• Alle sichtbaren Seiten des Berichts in der aktuellen Ansicht

• Alle Widgets und Visualisierungen mit ihren aktuellen Daten

• Aktuelle Filtereinstellungen - die Daten werden genau so exportiert, wie sie im Bericht angezeigt werden

• Titel und Beschreibungen aller Widgets

Tipps für optimale Exports

Vor dem Export:

• Stellen Sie sicher, dass alle Visualisierungen vollständig geladen sind

• Überprüfen Sie Ihre Filtereinstellungen - diese werden im PDF übernommen

• Bei mehreren Seiten: Navigieren Sie einmal durch alle Seiten, um sicherzustellen, dass alle Daten geladen sind

Leistung:

• Bei großen Berichten mit vielen Widgets kann die Generierung einige Sekunden bis Minuten dauern

• Komplexe Visualisierungen (große Tabellen, detaillierte Karten) benötigen mehr Zeit

• Bleiben Sie auf der Seite, bis der Download abgeschlossen ist

Verwendungszwecke:

• Präsentationen: Teilen Sie statische Berichte mit Stakeholdern ohne Plattformzugriff

• Archivierung: Speichern Sie Momentaufnahmen Ihrer Berichte für historische Vergleiche

• Drucken: Erstellen Sie gedruckte Kopien für Meetings oder offizielle Dokumentation

• Berichtswesen: Integrieren Sie Berichte in externe Dokumente oder Präsentationen

Textfilter

Perfekt für Abteilungsauswahl, Statusfilterung, Kategorien oder beliebige textbasierte Variablen in Ihren SQL-Abfragen.

Einzelauswahl

Stellen Sie sich die Organisation eines Berichts vor wie die Planung einer Gemeinderatssitzung. Sie benötigen verschiedene Bereiche für unterschiedliche Themen. Außerdem brauchen Sie eine klare Navigation, damit die Teilnehmer finden können, was sie benötigen. Und schließlich einen logischen Ablauf, der für alle Anwesenden verständlich ist.

Das dreistufige System

Die Berichtsstruktur verwendet drei Arten von Organisationselementen. Diese arbeiten zusammen, um klare und navigierbare Dokumente zu erstellen:

Wann Sie jeden Typ verwenden sollten

Verwenden Sie Seiten, wenn:

• Sie umfangreichen Inhalt zu präsentieren haben

• Themen separate Aufmerksamkeit und Raum benötigen

• Verschiedene Zielgruppen möglicherweise auf verschiedene Inhalte zugreifen

• Sie umfangreiche Formatierung und mehrere Inhaltsblöcke wünschen

Beispiele:

• Umfassende Haushaltsanalyse mit Diagrammen und Erklärungen

• Behördenleistungsüberprüfung mit Kennzahlen und Kommentaren

• Zusammenfassung mit wichtigen Highlights und Empfehlungen

Verwenden Sie Gruppen, wenn:

• Sie mehrere verwandte Seiten haben

• Inhalt logische Organisation benötigt

• Benutzer von hierarchischer Navigation profitieren

• Sie einklappbare Abschnitte für eine bessere Übersicht wünschen

Beispiele:

• Alle Finanzseiten unter "Haushalt & Finanzen" gruppiert

• Mehrere Behördenberichte unter "Behördenleistung" gruppiert

• Verschiedene Anhänge unter "Unterstützende Dokumentation" gruppiert

Verwenden Sie Abschnitte, wenn:

• Sie einfache Thementrennung benötigen

• Überschriften keine untergeordneten Inhalte erfordern

• Visuelle Pausen die Lesbarkeit verbessern

• Einfache Organisation ausreichend ist

Beispiele:

• "Methodik" - erklärt nur den Ansatz, keine Unterseiten erforderlich

• "Zusammenfassung" - einzelnes Thema, nicht mehrere Seiten

• "Danksagungen" - einfache Überschrift für Würdigungen

Erstellung Ihrer Berichtsstruktur

Tipps

Benennungskonventionen

• Verwenden Sie klare, beschreibende Namen, die den Inhalt anzeigen

• Vermeiden Sie interne Fachsprache, besonders für öffentlich zugängliche Berichte

• Seien Sie konsistent mit Benennungsmustern bei ähnlichen Elementen

• Berücksichtigen Sie Ihre Zielgruppe - verwenden Sie Terminologie, die sie verstehen

Strukturtiefe

• Begrenzen Sie Verschachtelung auf 2-3 Ebenen für Klarheit

• Gruppieren Sie verwandte Inhalte, aber vermeiden Sie Über-Kategorisierung

• Testen Sie die Navigation mit echten Benutzern, wenn möglich

• Halten Sie ähnliche Inhalte zusammen für einfachen Vergleich

Inhaltsverteilung

• Gleichen Sie Seitenlängen aus - vermeiden Sie übermäßig lange oder sehr kurze Seiten

• Gruppieren Sie ergänzende Informationen im selben Abschnitt

• Verwenden Sie Abschnitte sparsam - nur wenn einfache Überschriften ausreichen

• Berücksichtigen Sie den Lesefluss und logische Progression

Stellen Sie sich vor, Ihre Filteroptionen aktualisieren sich automatisch basierend auf Ihren tatsächlichen Daten - wie ein intelligenter Assistent, der immer die aktuellsten und relevantesten Auswahlmöglichkeiten bereitstellt, ohne dass Sie manuell Listen pflegen müssen.

Was sind dynamische Filteroptionen?

Dynamische Filteroptionen verwenden SQL-Abfragen, um Filter automatisch mit Werten aus Ihren Daten zu befüllen, anstatt diese manuell einzugeben:

• Automatisch aktualisiert - Filteroptionen spiegeln immer Ihre aktuellen Daten wider

• SQL-gesteuert - Schreiben Sie Abfragen, um verfügbare Werte zu ermitteln

• Anpassung an andere Filter - Optionen können sich basierend auf anderen Filtern ändern

• Datengetrieben - Keine manuellen Listen mehr pflegen

• Intelligent gefiltert - Zeigen Sie nur relevante, verfügbare Optionen

Beispiel aus der Praxis: Anstatt manuell alle Abteilungsnamen einzugeben, schreibt Ihr Filter eine SQL-Abfrage wie SELECT DISTINCT abteilung FROM mitarbeiter WHERE aktiv = true LIMIT 10000, um automatisch alle aktiven Abteilungen als Filteroptionen zu erhalten.

Dynamisch vs. manuell gesteuerte Filter

Wie dynamische Filter funktionieren

Das Grundprinzip:

1. SQL-Abfrage schreiben → Die erste Spalte der Ergebnisse wird zu Ihren Filteroptionen

2. Automatische Aktualisierung → Filter führt die Abfrage aus und lädt die aktuellen Werte

3. Variable Integration → Andere Filter können als $variablenname in der Abfrage verwendet werden

Beispiel-Ablauf:

• Benutzer wählt "Öffentliche Sicherheit" im Abteilungsfilter

• Status-Filter führt SQL-Abfrage aus: WHERE abteilung = 'Öffentliche Sicherheit'

• Status-Optionen zeigen nur relevante Werte für diese Abteilung

• Bei Abteilungsänderung aktualisieren sich die Status-Optionen automatisch

Dynamische Filter einrichten

Erweiterte Techniken

Abhängige Filter erstellen

Erstellen Sie Filter, die auf andere Filter reagieren:

Filter-Verkettung:

1. Bundesland-Filter → Benutzer wählt "Bayern"

2. Stadt-Filter → Zeigt nur bayerische Städte

3. Bezirk-Filter → Zeigt nur Bezirke der gewählten Stadt

Optimierung

Für große Datenmengen optimieren Sie Ihre Abfragen:

Praktische Beispiele

Beispiel 1: Abteilungsfilter mit aktiven Mitarbeitern

Beispiel 2: Statusfilter basierend auf Projekt und Jahr

Fehlerbehebung

"Keine Optionen verfügbar"

Mögliche Ursachen:

• SQL-Abfrage gibt keine Ergebnisse zurück

• Erste Spalte enthält nur NULL-Werte

Lösungsansätze:

"Filter aktualisiert sich nicht"

Häufige Probleme:

• Variablennamen stimmen nicht mit anderen Filtern überein

• SQL-Syntax-Fehler verhindert Ausführung

• Speicher-Probleme bei sehr häufigen Änderungen

Diagnose:

1. SQL-Editor öffnen → "Ausführen" klicken → Fehlermeldungen prüfen

2. Variable Namen überprüfen → Müssen exakt mit Filter-Systemnamen übereinstimmen

3. Browser-Cache leeren → Manchmal hilft ein Neuladen der Seite

"Leistungs-Probleme"

Für langsame Abfragen:

Best Practices

SQL-Abfragen schreiben

1. Erste Spalte ist entscheidend - Nur die erste Spalte wird für Optionen verwendet

2. DISTINCT verwenden - Vermeidet doppelte Einträge in der Dropdown-Liste

3. ORDER BY hinzufügen - Sortiert Optionen für bessere Benutzererfahrung

4. NULL-Werte filtern - Leere Optionen vermeiden

Variablen verwenden

1. Exakte Namen verwenden - $filter_systemname muss genau mit dem Filter-Systemnamen (Slug) übereinstimmen

2. NULL-Behandlung - Berücksichtigen Sie leere Filter: WHERE (status = $status OR $status IS NULL)

3. Typen beachten - Text-, Zahlen- und Datumsfilter haben verschiedene Formate

Wartung und Überwachung

1. Regelmäßig testen - Überprüfen Sie Filter nach Datenbank-Änderungen

2. Leistung überwachen - Langsame Abfragen können die Benutzererfahrung beeinträchtigen (maximal 10.000 Zeilen möglich)

3. Dokumentation - Kommentieren Sie komplexe SQL-Abfragen für andere Bearbeiter

Stellen Sie sich Berichtsfilter wie einen intelligenten Assistenten vor, der Ihnen nur die Informationen zeigt, die Sie interessieren. Anstatt einen riesigen Stapel Papiere durchzusehen, überreicht Ihnen Ihr Assistent nur die Seiten, die für Ihre aktuelle Frage relevant sind.

Zweck von Berichtsfiltern

Berichtsfilter ermöglichen es Ihnen, zu kontrollieren, welche Daten in Ihren Berichten erscheinen, indem sie sich mit SQL-Auswertungen mit Variablen verbinden:

• Spezifische Auswertungen filtern - Nur Auswertungen mit Variablen können gefiltert werden

• Seitenübergreifende Steuerung - Einen Filter mit Diagrammen auf mehreren Seiten verbinden

• Interaktive Steuerelemente - Bequeme Eingabefelder für Endbenutzer

• SQL-gesteuerte Logik - Filterlogik wird durch Ihr SQL-Abfrage-Design bestimmt

• Verschiedene Szenarien testen - Filterwerte ändern, um verschiedene Datenuntergruppen zu sehen

• Filterleisten-Sichtbarkeit kontrollieren - bestimmen Sie, welche Filter für Endbenutzer sichtbar sind

• Dynamische Filteroptionen - Filteroptionen automatisch aus Ihren Daten mit SQL-Abfragen generieren

Beispiel aus der Praxis: Ihr Budgetbericht hat eine SQL-Auswertung mit der Variable $abteilung. Sie fügen einen Abteilungsfilter zur Seite hinzu, der Benutzern ermöglicht, "Öffentliche Sicherheit" oder "Gesundheitsdienste" auszuwählen, um nur Daten für diese Abteilung zu sehen.

Globale Filter und lokale Überschreibungen

Wie Berichtsfilter funktionieren

1. SQL-Auswertungen mit Variablen erstellen - Verwenden Sie die Syntax $variablenname in Ihren SQL-Abfragen (siehe für die vollständige Anleitung)

2. Auswertungen zu Ihrem Bericht hinzufügen - Platzieren Sie Auswertungen mit Variablen auf den gewünschten Seiten

3. Filter einrichten - Verbinden Sie Filter mit den Auswertungsvariablen (auch auf anderen Seiten)

Filter über mehrere Seiten hinweg einsetzen

In der Filterkonfiguration sehen Sie, welche Auswertungen mit dem aktuellen Filter verbunden sind. Die Ansicht ist in zwei Bereiche aufgeteilt:

• Diese Seite – Auswertungen, die sich auf der aktuellen Seite befinden

• Andere Seiten – Auswertungen auf weiteren Seiten oder in anderen Berichtsabschnitten

Zu jeder Auswertung werden Seiten-Badges angezeigt, damit Sie schnell erkennen, wo der Filter wirkt. So können Sie denselben Filter auf mehreren Seiten einsetzen, ohne ihn doppelt pflegen zu müssen.

Wenn Sie sicherstellen möchten, dass überall derselbe Wert verwendet wird (z. B. für Soll-Ist-Reports oder Exporte), aktivieren Sie in den den Schalter Lokales Filter-Überschreiben verhindern.

Filter direkt im Bericht platzieren

Filter müssen nicht in der globalen Filterleiste bleiben. Über die Werkzeugleiste + Block → Filter platzieren Sie eine Filter-Komponente genau dort, wo Nutzer:innen sie benötigen – beispielsweise neben KPI-Kacheln oder unter einem erklärenden Abschnitt. Details finden Sie im Leitfaden .

Arten von Berichtsfiltern

Textfilter

Filtern basierend auf Textwerten:

• Einzelauswahl: Eine Abteilung aus einer Dropdown-Liste auswählen

• Mehrfachauswahl: Mehrere Projektstatus aus Checkboxen auswählen

• Texteingabe: Einen spezifischen Namen oder Identifikator eingeben

• Kategoriefilterung: Aus vordefinierter Liste von Regionen oder Typen auswählen

Zahlenfilter

Filtern basierend auf numerischen Werten:

• Einzelzahl: Einen minimalen Budgetbetrag eingeben

• Zahlenauswahl: Aus einer Liste von Prioritätsstufen auswählen (1, 2, 3)

• Schwellenwertfilterung: Mindest- oder Höchstwerte festlegen

Datumsfilter

Filtern basierend auf spezifischen Daten:

• Einzeldatumsauswahl: Ein spezifisches Berichtsdatum auswählen

• Datumsvergleich: Nach Datensätzen vor oder nach einem bestimmten Datum filtern

• Datumsabgleich: Daten für einen spezifischen Tag oder ein Datum anzeigen

Wie Benutzer mit Filtern interagieren

Sobald Filter eingerichtet sind, sehen Benutzer sie als interaktive Filter im oberen rechten Bereich des Berichts.

Filteroberfläche

Jeder Filter erscheint wie folgt:

• Filtername (das von Ihnen konfigurierte Etikett)

• Aktueller Wert (falls ein Wert ausgewählt ist)

• Klicken zum Öffnen der Filteroptionen

Filterinteraktionen

Globale Filter und Auswertungsfilter

Erste Schritte mit Filtern

Bereit, mit der Filterung Ihrer Berichte zu beginnen?

• - Richten Sie Ihre ersten Berichtsfilter Schritt für Schritt ein, einschließlich Sichtbarkeit und Mehrseiten-Verknüpfung

• - Steuern Sie Standardwerte, Sichtbarkeit und das lokale Überschreiben

• - Binden Sie Filter direkt in das Berichtslayout ein

• - Automatische Filteroptionen aus Ihren Daten mit SQL-Abfragen

Anforderungen für die Verwendung von Berichtsfiltern

Sie müssen benutzerdefinierte SQL-Auswertungen mit Variablen verwenden, um Berichtsfilterung zu aktivieren. Was Sie benötigen:

SQL-Auswertungen mit Variablen

1. SQL-Auswertungen erstellen: Verwenden Sie den SQL-Editor, um benutzerdefinierte Abfragen zu schreiben

2. Variablen hinzufügen: Schließen Sie die Syntax $variablenname in Ihre SQL-Abfragen ein

3. NULL-Werte behandeln: Verwenden Sie ordnungsgemäße SQL-Logik für den Fall, dass kein Filter angewendet wird

Beispiel-SQL-Muster:

Manuelle Filterkonfiguration

• Filterwerte bereitstellen: Sie müssen die Liste der verfügbaren Optionen für jeden Filter manuell eingeben

• Keine automatische Erkennung: Das System erkennt nicht automatisch verfügbare Werte aus Ihren Daten

• Filtertypen konfigurieren: Richten Sie Text-, Zahlen- oder Datumsfilter basierend auf Ihren Variablentypen ein

• Filtersichtbarkeit konfigurieren: Entscheiden Sie für jeden Filter, ob er in der oberen Leiste angezeigt werden soll oder nur auf der Auswertung

Mehr über Variablen erfahren

Für vollständige Details über das Erstellen von SQL-Auswertungen mit Variablen, siehe .

Für eine schrittweise Filtereinrichtung, siehe die .

Variablen ermöglichen es Ihnen, dynamische Werte in Textblöcken zu verwenden, die sich automatisch aktualisieren. Sie können feste Werte oder SQL-Abfragen als Variablen definieren und diese überall in Ihren Berichten einfügen.

Was sind Bericht-Variablen?

Stellen Sie sich vor, Sie erstellen einen monatlichen Bericht über Krankheitsfälle. Anstatt jedes Mal "Januar 2024" manuell zu ändern, könnten Sie eine Variable $aktueller_monat erstellen, die sich automatisch aktualisiert.

Variablen sind:

• Wiederverwendbare Werte, die Sie in Textblöcken einfügen können

• Entweder fest definiert ("Berlin") oder dynamisch über SQL-Abfragen

• Überall im Bericht verwendbar – in Überschriften, Texten, Listen

• Automatisch aktualisierend bei dynamischen Werten

Wann Variablen verwenden?

✅ Ideal für:

• Wiederkehrende Berichte mit sich ändernden Zeiträumen

• Zentrale Werte, die an mehreren Stellen verwendet werden

• Dynamische Daten aus Datenbanken (z.B. aktuellste Zahlen)

• Konsistente Bezeichnungen über den gesamten Bericht

Beispiele:

• Zeiträume: "Bericht für $monat $jahr" → "Bericht für Januar 2025"

• Metriken: "Gesamt: $gesamtzahl Fälle" → "Gesamt: 1.234 Fälle"

• Standorte: "Region: $region" → "Region: Berlin"

• Status: "Stand: $letztes_update" → "Stand: 15.01.2025"

Variablen erstellen

Variablen verwenden

Variable einfügen

1. Klicken Sie an die Stelle, wo die Variable erscheinen soll

2. Tippen Sie $

3. Wählen Sie eine Variable aus der Liste oder geben Sie einen neuen Namen ein

4. Die Variable wird eingefügt und zeigt ihren aktuellen Wert

Variable bearbeiten

Im Bearbeitungsmodus:

1. Klicken Sie auf eine eingefügte Variable

2. Das Einstellungsfenster öffnet sich

3. Ändern Sie Wert, Abfrage oder Einstellungen

4. Speichern Sie – alle Vorkommen aktualisieren sich automatisch

Variable formatieren

Variablen unterstützen Textformatierung:

• Fett, Kursiv, Unterstrichen

• Farben (Text und Hintergrund)

• Schriftgröße

Markieren Sie die Variable und wenden Sie die gewünschte Formatierung an – genau wie normalen Text.

Variablentypen im Detail

Feste Werte

Wann verwenden:

• Projektnamen, Abteilungen, Standorte

• Zeiträume, die manuell aktualisiert werden

• Zentrale Bezeichnungen für Konsistenz

Vorteile:

• Einfach zu verstehen und zu pflegen

• Sofort verfügbar, keine Datenbanklast

• Perfekt für wiederkehrende Texte

Beispiel:

Verwendung: "Das $abteilung meldet folgende Zahlen..." Ergebnis: "Das Gesundheitsamt Berlin-Mitte meldet folgende Zahlen..."

SQL-Abfragen

Wann verwenden:

• Aktuelle Zahlen, die sich häufig ändern

• Berechnete Metriken

• Datengetriebene Werte

Vorteile:

• Immer aktuell

• Automatische Berechnung

• Reduziert manuelle Arbeit

Wichtig:

• Die Abfrage muss genau einen Wert zurückgeben (erste Spalte, erste Zeile)

• Variablen mit Abfragen zeigen "Lädt..." während der Ausführung

• Bei Fehlern erscheint "[Kein Wert]"

Beispiel:

Verwendung: "In diesem Monat wurden $abgeschlossen Anträge abgeschlossen." Ergebnis: "In diesem Monat wurden 127 Anträge abgeschlossen."

Variablen vs. Filter

Häufige Fehler vermeiden

❌ Variable zeigt "[Kein Wert]"

Ursachen:

• Bei festem Wert: Wert wurde nicht ausgefüllt

• Bei Abfrage: SQL-Abfrage liefert kein Ergebnis

• Bei Abfrage: Syntaxfehler in der SQL-Abfrage

Lösung:

• Klicken Sie auf die Variable, um Einstellungen zu öffnen

• Prüfen Sie den Wert oder die Abfrage

• Bei Abfragen: Testen Sie die SQL-Abfrage in einer Auswertung

❌ Variable zeigt "Fehlt: variablenname"

Ursache: Die Variable wurde gelöscht, wird aber noch im Text referenziert

Lösung:

• Löschen Sie die fehlerhafte Referenz aus dem Text

• Oder erstellen Sie die Variable neu mit dem gleichen Systemnamen

❌ Variable aktualisiert sich nicht

Problem: Wert bleibt alt, obwohl sich Daten geändert haben

Ursache: Abfrage-Variablen werden gecacht

Lösung:

• Aktualisieren Sie den Bericht (Seite neu laden)

• Oder öffnen Sie die Variable und speichern Sie sie erneut

Bewährte Methoden

✅ Empfohlen

• Klare Namen: "gesamtzahl_faelle" statt "var1"

• Zentrale Werte: Nutzen Sie Variablen für Werte, die mehrfach vorkommen

• Dokumentation: Bei komplexen Abfragen notieren Sie, was sie berechnen

• Konsistenz: Verwenden Sie einheitliche Namenskonventionen

❌ Vermeiden Sie

• Zu viele Variablen: Mehr als 10-15 wird unübersichtlich

• Komplexe Abfragen: Halten Sie SQL-Abfragen einfach

• Doppelte Systemnamen: Jeder Systemname muss eindeutig sein

• Sehr lange Werte: Feste Werte sollten nicht zu lang sein (wirkt sich auf Anordnung aus)

Variablen löschen

1. Klicken Sie auf die Variable im Text

2. Im Einstellungsfenster klicken Sie Entfernen

3. Bestätigen Sie die Löschung

4. Die Variable verschwindet aus dem Text

Bericht-Variablen vs. SQL-Variablen

Es gibt zwei verschiedene Arten von Variablen in Polyteia, die NICHT verwechselt werden sollten, auch wenn beide die $-Syntax verwenden:

Bericht-Variablen (diese Seite)

Was sind sie? Dynamische Werte, die Sie in Textblöcke von Berichten einfügen können.

Wo werden sie verwendet?

• In Textblöcken (Überschriften, Absätze, Listen)

• Direkt im Bericht-Editor

• Überall, wo Sie Text schreiben können

Wie erstellt man sie?

• Tippen Sie $ in einem Textblock

• Wählen Sie aus der Liste oder erstellen Sie eine neue Variable

• Konfigurieren Sie festen Wert oder SQL-Abfrage

Was tun sie?

• Zeigen einen Wert direkt im Text an

• Können feste Texte oder berechnete Werte sein

• Aktualisieren sich automatisch bei SQL-Abfragen

Beispiel:

SQL-Variablen (in Auswertungen)

Was sind sie? Filter-Parameter für SQL-Abfragen in Auswertungen.

Wo werden sie verwendet?

• In der WHERE-Klausel von SQL-Abfragen

• Im SQL-Editor von Auswertungen

• Nur in Auswertungen, nicht in Textblöcken

Wie erstellt man sie?

• Schreiben Sie $variable in einer WHERE-Klausel

• Definieren Sie den Variablentyp (Text, Zahl, Datum)

• Konfigurieren Sie Einzel- oder Mehrfachauswahl

Was tun sie?

• Filtern Daten in SQL-Abfragen

• Werden zu interaktiven Filtern in Berichten

• Ermöglichen Benutzern, Daten zu filtern

Beispiel:

→ Mehr dazu:

Schnellvergleich

Wann welche verwenden?

Verwenden Sie Bericht-Variablen, wenn Sie:

• Einen Wert im Text anzeigen möchten

• Zeiträume, Metriken oder Bezeichnungen wiederverwenden wollen

• Dynamische Zahlen aus Datenbanken in Texten brauchen

• Konsistente Werte über den gesamten Bericht sicherstellen möchten

Verwenden Sie SQL-Variablen, wenn Sie:

• Daten in einer Auswertung filtern möchten

• Benutzern ermöglichen wollen, Filterkriterien zu ändern

• WHERE-Bedingungen in SQL-Abfragen dynamisch gestalten wollen

• Interaktive Filter in Berichten benötigen

Weitere Hilfe

→ – Grundlagen für Berichte

→ – Interaktive Filter für Auswertungen

→ – SQL-gesteuerte Filter

Filter für Berichte zu erstellen ist wie das Verbinden eines Bedienfelds mit bestimmten Maschinen – Sie bauen benutzerfreundliche Steuerelemente auf, die sich mit SQL-Auswertungen mit Variablen verbinden und Nutzer:innen ermöglichen, zu bestimmen, welche Daten sie sehen. Ein einziger Filter kann dabei mehrere Widgets auf unterschiedlichen Seiten steuern.

Bevor Sie beginnen

Sie benötigen:

• SQL-Auswertungen mit Variablen – Auswertungen, die die Syntax $variablenname in benutzerdefinierten SQL-Abfragen verwenden

• Bericht mit SQL-Auswertungen – Platzieren Sie die Auswertungen auf den Seiten, auf denen der Filter wirken soll (auch mehrere Seiten möglich)

• Manuelle Filterwerte – Sie müssen die Liste der verfügbaren Optionen für jeden Filter bereitstellen

• Verständnis der Variablen-Logik – Wie Ihr SQL NULL-Werte behandelt, wenn kein Filter angewendet wird

Filtererstellung Schritt-für-Schritt

Erweiterte Filtertechniken

Mehrere Filter auf einer Seite

Erstellen Sie mehrere Filter, die zusammenarbeiten:

• Abteilungsfilter beeinflusst Budget- und Leistungsauswertungen

• Datumsfilter beeinflusst alle zeitbasierten Auswertungen

• Statusfilter beeinflusst projektbezogene Auswertungen

Jeder Filter funktioniert unabhängig basierend auf seinen verbundenen Auswertungen.

Komplexe Logik in SQL

Für erweiterte Filterlogik bauen Sie sie in Ihre SQL-Abfragen ein:

Die komplexe Logik bleibt in SQL - die Filteroberfläche bleibt einfach.

Überschreibungen

Benutzer können Filterwerte für einzelne Auswertungen temporär ändern:

• Nützlich für das Vergleichen verschiedener Szenarien

• Änderungen werden nicht gespeichert (nur temporäres Testen)

• Jede Auswertung kann unabhängig angepasst werden

Fehlerbehebung bei Filterproblemen

"Mein Filter zeigt keine Daten"

• Überprüfen Sie, dass SQL-Variablennamen exakt mit Filtervariablennamen übereinstimmen

• Stellen Sie sicher, dass Ihr SQL NULL-Behandlung enthält: (column = $variable OR $variable IS NULL)

• Bestätigen Sie, dass Filterwerte mit tatsächlichen Datenwerten in Ihrer Datenbank übereinstimmen

• Testen Sie die SQL-Auswertung zuerst unabhängig

"Filter hat keine Auswirkung auf Auswertungen"

• Überprüfen Sie, dass Variablennamen exakt zwischen SQL und Filter übereinstimmen

• Stellen Sie sicher, dass Auswertungen ordnungsgemäß mit dem Filter verbunden sind

• Stellen Sie sicher, dass Auswertungen die korrekte SQL-Variablensyntax verwenden: $variablenname

• Bestätigen Sie, dass Auswertungen SQL-basiert sind (nicht visuelles Drag-and-Drop)

"Einige Auswertungen reagieren nicht auf Filter"

• Nur Auswertungen mit passenden Variablennamen werden gefiltert

• Überprüfen Sie, dass jede Auswertung die korrekte Variable in ihrer SQL-Abfrage hat

"Filter zeigt 'keine Daten', wenn leer"

• Ihrer SQL-Abfrage fehlt NULL-Behandlung

• Fügen Sie OR $variable IS NULL-Bedingungen hinzu, um alle Daten zu zeigen, wenn kein Filter angewendet wird

• Testen Sie die SQL-Logik zuerst im Auswertungseditor

Variablen in SQL-Auswertungen verwenden

Wenn Sie Auswertungen mit benutzerdefinierten SQL-Abfragen erstellen, die in gefilterten Berichten verwendet werden, müssen Sie Fälle behandeln, in denen Filtervariablen null sein könnten (wenn kein Filter angewendet wird).

Variablenbehandlung in SQL

Tipps für Variablen-SQL

1. Immer Null-Fälle behandeln - Jede Variable sollte eine Bedingung OR $variable IS NULL haben

2. Mit und ohne Filter testen - Überprüfen Sie, dass Ihre Abfrage sowohl mit angewendeten als auch leeren Filtern funktioniert

3. Konsistente Muster verwenden - Wenden Sie denselben Null-Behandlungsansatz über alle Ihre SQL-Auswertungen hinweg an

Häufige Variablenmuster

Datumsbereich-Filterung:

Numerische Bereich-Filterung:

Text-Filterung:

Mehrfeld-Filterung:

Ihre Variablen-Logik testen

1. Erstellen Sie Ihre SQL-Auswertung mit ordnungsgemäßer NULL-Behandlung

2. Testen Sie die Auswertung unabhängig mit verschiedenen Variablenwerten

3. Fügen Sie Auswertung zu einer Berichtsseite hinzu

4. Erstellen und verbinden Sie Seitenfilter