Datenbank-Widgets

Datenbank-Widgets sind visuelle Bausteine, mit denen du Daten aus deinen Datenbanken direkt in CLYE AI darstellen kannst, als Diagramme, Kennzahlen oder Tabellen.

Was sind Datenbank-Widgets?

Ein Widget ist eine konfigurierbare Ansicht, die Daten aus einer angebundenen Datenbank abfragt und visualisiert. Du kannst:

• Kennzahlen anzeigen: Summen, Durchschnitte, aktuelle Werte
• Diagramme erstellen: Balken-, Linien- und Kreisdiagramme
• Tabellen darstellen: Rohdaten mit Filtern und Sortierung
• Zeitreihen vergleichen: Entwicklung über Zeiträume

Wann Widgets sinnvoll sind

• Dashboards: Zentrale Übersicht über wichtige Kennzahlen
• Monitoring: Aktuelle Werte und Trends im Blick behalten
• Berichte: Regelmäßige Auswertungen automatisiert darstellen
• Team-Information: Gemeinsame Datenansichten für alle Teammitglieder

Widget konfigurieren

1. Öffne die Datenbank, die du nutzen willst
2. Wähle den Bereich Widgets oder Dashboards
3. Klicke auf Neues Widget
4. Wähle den Widget-Typ (Kennzahl, Diagramm, Tabelle)
5. Konfiguriere die Datenquelle (Tabelle, Abfrage)
6. Passe das Layout an (Größe, Farbe, Titel)
7. Speichere das Widget

Wenn du den Titel eines Widgets änderst oder eine eigene SQL-Abfrage speicherst, bleiben diese Werte nach dem Neuladen jetzt zuverlässig erhalten. Das gilt auch für Widgets, deren Konfiguration durch ältere Speicherstände bereits fehlerhaft als JSON-Text statt als Objekt in der Datenbank lag: CLYE AI liest solche vorhandenen Widget-Konfigurationen beim Öffnen wieder korrekt ein.

Bei Diagrammen wählt CLYE AI für die X-Achse standardmäßig wieder passendere Datums-Spalten, wenn deine Abfrage solche Spalten enthält. Statt versehentlich auf einer technischen Spalte wie id zu landen, wird im Visualisierungsdialog damit typischerweise direkt die fachlich sinnvolle Datumsachse vorausgewählt.

Widget-Karten im Arbeitsbereich

Wenn ein Widget als Karte im Arbeitsbereich oder in einer Listenansicht erscheint, nutzt CLYE AI jetzt ein einheitliches Kartenlayout. Die erweiterte Widget-Darstellung ist nicht mehr von einem separaten Feature-Flag abhängig.

Das bedeutet für dich:

• Widget-Karten zeigen ihre spezielle Darstellung jetzt durchgängig, wenn der Inhalt ein Widget ist.
• Du musst dafür kein zusätzliches Flag aktivieren oder prüfen.
• Screenshots und Beschreibungen zu Widget-Karten gelten damit allgemein und nicht nur für einzelne Freischaltungen.

Widgets in Advanced Dashboards

Bei aktivem Feature-Flag advancedDashboards kannst du vorhandene SQL-Widgets auch in Advanced Dashboards einer Datenbank verwenden. Dort liegen KI-Bereiche, Katalog-Widgets, klassische SQL-Widgets und – wenn im Space freigeschaltet – auch Hosted Apps im selben Raster.

Wichtig für den Alltag:

• du legst SQL-Widgets weiterhin wie gewohnt in der Datenbank an
• im Advanced Dashboard öffnest du Widget hinzufügen und wählst je nach Freischaltung einen Tab wie Katalog, Manuell, SQL oder Hosted App
• die Tabs im Widget-Sheet haben eigene Icons, damit du schneller zum passenden Bereich wechselst
• im Katalog kannst du nach Widgets suchen und vor dem Einfügen direkt eine Beispielvorschau prüfen
• wenn keine weiteren SQL-Widgets angeboten werden, lege das gewünschte Widget zuerst unter Ansichten an
• das Dashboard selbst bleibt an die jeweilige Datenbank gebunden und nutzt in Team-Szenarien den geteilten Team-Space der Datenbank
• Speichern, Hinzufügen und Generieren funktionieren deshalb auch dann im gemeinsam genutzten Dashboard, wenn das Dashboard nicht in deinem persönlichen Space liegt
• wenn beim Speichern oder Generieren ein Fehler auftritt, erscheint dafür jetzt nur noch eine Fehlermeldung statt doppelt

Hosted Apps als Widget einfügen

Wenn in deinem Space das Feature-Flag hostedAppTools aktiv ist, erscheint im Dialog Widget hinzufügen zusätzlich der Tab Hosted App.

So gehst du vor:

1. Öffne das gewünschte Advanced Dashboard im Bearbeitungsmodus.
2. Klicke auf Widget hinzufügen.
3. Wechsle zum Tab Hosted App.
4. Wähle eine vorhandene Hosted App aus deinem Space aus.
5. Prüfe die Vorschau direkt im Dialog.
6. Passe bei Bedarf Titel und URL an.
7. Hänge optionale Query-Parameter direkt an die URL an, zum Beispiel ?kunde=acme.
8. Klicke auf Hinzufügen.

Wichtig dabei:

• der Tab Hosted App ist nur sichtbar, wenn hostedAppTools für deinen Space aktiv ist
• du kannst nur Hosted Apps aus dem aktuellen Space auswählen
• ist das Dashboard keinem Space zugeordnet, lassen sich dort keine Hosted Apps auswählen
• wenn im Space noch keine Hosted Apps vorhanden sind, bleibt der Tab leer
• nach dem Speichern schließt sich der Bearbeiten-Dialog wieder regulär, wenn die Änderung erfolgreich übernommen wurde

So kombinierst du generierte Bereiche für Zusammenfassungen oder Einordnungen mit festen Zahlen, Tabellen, Diagrammen und eingebetteten Hosted Apps in einem gemeinsamen Dashboard.

Widget-Typen

Typ	Beschreibung	Geeignet für
Kennzahl	Einzelner Wert (Zahl)	Aktuelle Umsätze, offene Tickets
Balkendiagramm	Vergleich von Werten	Umsatz pro Monat, Tickets pro Kategorie
Liniendiagramm	Entwicklung über Zeit	Nutzerwachstum, tägliche Aktivität
Kreisdiagramm	Anteile an einem Ganzen	Verteilung nach Kategorie, Status
Tabelle	Detaildaten mit Filtern	Alle offenen Vorgänge, letzte Transaktionen

tipp

Beginne mit 2-3 Widgets, die die wichtigsten Kennzahlen abdecken. Zu viele Widgets auf einmal erschweren den Überblick.

SQL-Abfragen mit WITH in Widgets

Wenn du in einem Datenbank-Widget mit einer eigenen SQL-Abfrage arbeitest, kannst du auch WITH-Klauseln verwenden. Das gilt sowohl für klassische CTEs als auch für einfache Aliase wie in ClickHouse, zum Beispiel WITH toDate({$start}) AS d SELECT ....

Wichtig für die Nutzung im Alltag:

• Sortierung des Widgets bleibt mit vorhandenen WITH-Klauseln nutzbar
• Tabellenfußzeilen in Tabellen-Widgets funktionieren auch dann weiter
• auch bei aktiven Berechtigungsfiltern bleibt eine gültige WITH-Abfrage nutzbar

Praktisches Beispiel:

WITH toDate({$start}) AS d
SELECT
  d AS tag,
  count(*) AS anzahl
FROM ereignisse
GROUP BY d
ORDER BY d

Wenn du mehrere CTEs hintereinander verwendest, formuliere sie wie üblich in einer gemeinsamen WITH-Klausel. Beispiel:

WITH a AS (
  SELECT * FROM basisdaten
),
b AS (
  SELECT * FROM a WHERE status = 'offen'
)
SELECT *
FROM b

Wenn ein Widget trotz gültiger Abfrage keine Daten zeigt, prüfe zuerst, ob die Abfrage auch mit den für dich sichtbaren Daten und gesetzten Filtern sinnvoll bleibt.

Verhalten bei Größenänderungen und Tabellenbreiten

Datenbank-Widgets und tabellarische Ansichten verhalten sich inzwischen stabiler, wenn sich die verfügbare Breite ändert. Das ist besonders hilfreich in Dashboards, Seitenleisten oder bei kleineren Fenstern.

Darauf kannst du dich im Alltag verlassen:

• angepasste Spaltenbreiten bleiben konsistenter erhalten
• Widgets reagieren stabiler auf Resize-Ereignisse
• Tabellen springen seltener unerwartet auf alte Breiten zurück

Empfehlung:

• Lege zuerst sinnvolle Spaltenbreiten fest.
• Prüfe danach die Darstellung in einem schmaleren Layout.
• Speichere das Dashboard erst, wenn Kennzahlen, Achsen und Tabellenüberschriften gut lesbar sind.