Filter erstellen

Schritt-für-Schritt-Anleitung zur Einrichtung von Seitenebenen-Filtern, die sich mit SQL-Auswertungen mit Variablen verbinden.

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 Benutzern ermöglichen, zu ändern, welche Daten sie sehen.

Bevor Sie beginnen

Sie benötigen:

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

• Bericht mit SQL-Auswertungen - Auswertungen, die zu Seiten hinzugefügt wurden, wo Sie Filterung wünschen

• 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

1

Zugriff auf Filtereinstellungen

1. Öffnen Sie Ihren Bericht im Bearbeitungsmodus

2. Suchen Sie nach der Schaltfläche "Filter hinzufügen" im oberen rechten Bereich der Berichtsseite

3. Klicken Sie auf "Filter hinzufügen", um die Filtereinstellungen zu öffnen

4. Die Einstellungen öffnet sich mit der Überschrift "Filter erstellen" und zwei Registerkarten: Einstellungen und Auswertungen

Die Schaltfläche "Filter hinzufügen" wird deaktiviert, wenn keine Auswertungen verfügbar sind, mit denen Filter verbunden werden können. Sie benötigen zuerst SQL-Auswertungen mit Variablen auf der Berichtsseite.

2

Filter-Grundlagen konfigurieren

In der Registerkarte Einstellungen richten Sie Ihren Filter ein:

1. Bezeichnung: Geben Sie einen klaren, beschreibenden Namen ein (maximal 50 Zeichen)

   • Beispiel: "Abteilungsauswahl" oder "Berichtsdatum"

   • Dies erscheint Benutzern als Filtername

2. Slug: Automatisch aus der Bezeichnung generiert (kann bearbeitet werden)

   • Wird intern für die Filteridentifikation verwendet

   • Muss über alle Filter hinweg eindeutig sein

3. Typ: Wählen Sie den Datentyp:

   • Text - für Abteilungen, Status, Kategorien

   • Zahl - für Beträge, Zählungen, Schwellenwerte

   • Datum - für zeitbasierte Filterung

Der Slug wird automatisch aus Ihrer Bezeichnung generiert, kann aber bei Bedarf angepasst werden. Sowohl Bezeichnung als auch Slug müssen eindeutig sein.

3

Eingabeoptionen konfigurieren

Wählen Sie aus, wie Benutzer mit dem Filter interagieren werden:

Eingabefeld

Freie Text-/Zahlen-/Datumseingabe:

• Text: Benutzer geben beliebige Textwerte ein

• Zahl: Benutzer geben numerische Werte ein (Dezimalzahlen und negative Zahlen erlaubt)

• Datum: Benutzer geben Daten im Format JJJJ-MM-TT ein

Am besten für: Wenn Sie nicht alle möglichen Werte vorhersagen können oder maximale Flexibilität wünschen

Auswahlliste

Vordefinierte Optionen aus benutzerdefinierten Werten:

1. Wählen Sie "Auswahlliste" als Eingabeoption

2. Benutzerdefinierte Werte eingeben in das Textfeld:

   • Mit Semikolons (;) ODER Zeilenumbrüchen trennen

   • Mischen Sie keine Trennzeichen im selben Filter

   • Beispiel: Öffentliche Sicherheit; Gesundheitsdienste; Öffentliche Arbeiten

3. Auswahlmodus wählen:

   • Einzelauswahl: Benutzer wählen eine Option

   • Mehrfachauswahl: Benutzer können mehrere Optionen auswählen

Am besten für: Wenn Sie eine bekannte Menge gültiger Optionen haben

Kalender (nur Datum)

Interaktive Datumsauswahl:

• Nur verfügbar für Filter vom Typ Datum

• Benutzer sehen eine Kalenderoberfläche

• Nur Einzeldatumsauswahl

Am besten für: Datumsauswahl mit benutzerfreundlicher Kalenderoberfläche

4

Optionale Konfigurationen setzen

Zusätzliches Filterverhalten konfigurieren:

Standardwert

Startwert festlegen:

1. "Standardwert" aktivieren

2. Standard auswählen basierend auf Filtertyp:

   • Text/Zahl: Standardwert eingeben

   • Datum: Kalenderauswahl verwenden

   • Auswahlliste: Aus Ihren benutzerdefinierten Werten auswählen

Benutzer sehen: Filter beginnt mit diesem ausgewählten Wert

Wert immer erforderlich

Benutzer zur Eingabe zwingen:

1. "Wert immer erforderlich" aktivieren

2. Benutzer müssen einen Wert auswählen/eingeben, um Daten zu sehen

3. Erfordert Standardwert, wenn aktiviert

Verwenden, wenn: Filter für sinnvolle Datenanzeige unerlässlich ist

5

Mit Auswertungen verbinden

Wechseln Sie zur Registerkarte Auswertungen, um Ihren Filter zu verbinden:

1. Alle Auswertungen anzeigen auf Ihrer Seite mit ihren Diagrammtyp-Symbolen

2. Für jede Auswertung, die Sie verbinden möchten:

   • Auswertung in der Liste finden

   • Menü daneben anklicken

   • SQL-Variable auswählen (z.B. $department, $status)

3. Verbindungsstatus zeigt, ob jede Auswertung verbunden ist

4. Mehrere Verbindungen: Ein Filter kann sich mit mehreren Auswertungen mit verschiedenen Variablennamen verbinden

6

Filter speichern

Filtererstellung abschließen:

1. Einstellungen überprüfen in den Registerkarten Einstellungen und Auswertungen

2. "Speichern" klicken (oder "Mit Auswertung verbinden", wenn noch keine Auswertungen verbunden)

3. Filter erscheint als Feld im oberen rechten Filterbereich

4. Verbundene Filter zeigen sich als funktionsfähige Felder

Nach dem Speichern:

• Filter erscheint auf der Berichtsseite

• Benutzer können mit dem Filter interagieren

• Verbundene Auswertungen aktualisieren sich basierend auf Filterwerten

• Sie können den Filter bearbeiten, indem Sie den Filter anklicken und auf "Bearbeiten" klicken

Ihr Filter ist jetzt aktiviert. Benutzer werden die von Ihnen konfigurierte Filteroberfläche sehen und können damit interagieren, um zu ändern, welche Daten in verbundenen Auswertungen erscheinen.

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:

SELECT * FROM projects
WHERE (status IN $status_list OR $status_list IS NULL)
  AND (department = $department OR $department IS NULL)
  AND (budget >= $min_budget OR $min_budget IS NULL)
  AND (priority = 'High' OR deadline < CURRENT_DATE + INTERVAL 30 DAY)

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

Einzelwert-Filter

Für Einzelauswahl-Filter (wie Abteilungs-Dropdown):

Problem: Wenn keine Abteilung ausgewählt ist, wird $department null sein und Ihre Abfrage wird alle Daten ausschließen.

Lösung: Verwenden Sie dieses Muster in Ihrem SQL:

SELECT * 
FROM your_table 
WHERE (department = $department OR $department IS NULL)

Wie es funktioniert:

• Wenn Filter angewendet wird: Zeigt nur die ausgewählte Abteilung

• Wenn Filter leer ist: Zeigt alle Abteilungen (weil $department IS NULL wahr wird)

Reales Beispiel:

SELECT 
    department,
    COUNT(*) as project_count,
    SUM(budget) as total_budget
FROM projects 
WHERE (department = $department OR $department IS NULL)
    AND (status = $status OR $status IS NULL)
GROUP BY department

Mehrfachauswahl-Filter

Für Mehrfachauswahl-Filter (wie Status-Checkboxen):

Problem: Wenn keine Status ausgewählt sind, wird $status_list null sein und alle Daten ausschließen.

Lösung: Verwenden Sie dieses Muster in Ihrem SQL:

SELECT * 
FROM your_table 
WHERE (status IN ($status_list) OR $status_list IS NULL)

Reales Beispiel:

SELECT 
    project_name,
    status,
    budget,
    start_date
FROM projects 
WHERE (status IN ($status_list) OR $status_list IS NULL)
    AND (department = $department OR $department IS NULL)
    AND (start_date >= $start_date OR $start_date IS NULL)
ORDER BY start_date DESC

Hinweis: Der IN-Operator ist in der SQL-Engine der Plattform bestätigt verfügbar. Mehrfachauswahl-Filtervariablen werden als durch Semikolons getrennte Listen übergeben, die mit dem IN-Operator funktionieren.

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

4. Ihre Variablen dokumentieren - Fügen Sie Kommentare hinzu, die erklären, was jede Variable darstellt

Häufige Variablenmuster

Datumsbereich-Filterung:

WHERE (created_date >= $start_date OR $start_date IS NULL)
    AND (created_date <= $end_date OR $end_date IS NULL)

Numerische Bereich-Filterung:

WHERE (budget >= $min_budget OR $min_budget IS NULL)
    AND (budget <= $max_budget OR $max_budget IS NULL)

Text-Filterung:

WHERE (description LIKE '%' || $search_term || '%' OR $search_term IS NULL)

Mehrfeld-Filterung:

WHERE (department = $department OR $department IS NULL)
    AND (priority IN $priority_list OR $priority_list IS NULL)
    AND (region = $region OR $region IS NULL)

Wichtig: Ohne ordnungsgemäße Null-Behandlung können Ihre gefilterten Berichte leere Diagramme zeigen, wenn Filter nicht angewendet werden. Testen Sie Ihre SQL-Auswertungen immer sowohl mit als auch ohne aktive Berichtsfilter.

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

5. Testen Sie Filterverhalten:

   • Keine Auswahl - sollte alle Daten zeigen

   • Einzelauswahl - sollte gefilterte Untergruppe zeigen

   • Mehrere Auswahlen (wenn Mehrfachauswahl) - sollte kombinierte Ergebnisse zeigen

   • Filter löschen - sollte zur Anzeige aller Daten zurückkehren

Profi-Tipp: Testen Sie Ihre SQL-Variablen-Logik immer im Auswertungseditor, bevor Sie sie zu Berichten hinzufügen. Verwenden Sie die Steuerelemente für die Variablen, um verschiedene Werte zu testen und sicherzustellen, dass die NULL-Behandlung korrekt funktioniert.