Seminar Sanity GROQ Grundlagen

Im Mittelpunkt stehen sichere Formulierung, Parametrisierung und Prüfung grundlegender GROQ-Abfragen. Die Inhalte werden an einem durchgängigen Praxisfall erarbeitet und so strukturiert, dass fachliche Entscheidungen, technische Umsetzung und betriebliche Anforderungen nachvollziehbar zusammenwirken.

Inhaltsübersicht

1. Zielsetzung
2. Zielgruppe
3. Voraussetzungen
4. Seminarinhalte
5. Praxisübungen
6. Qualitätssicherung
7. Methodik

Zielsetzung

Das Seminar entwickelt die erforderlichen Kenntnisse systematisch von der Einordnung bis zur kontrollierten Umsetzung.

• Dokumente zuverlässig filtern, sortieren und begrenzen
• Ergebnisse mit Projektionen an den Bedarf der Anwendung anpassen
• Referenzen und Arrays in typischen Inhaltsmodellen abfragen

Zielgruppe

Frontend-, Backend- und Content-Engineering-Rollen mit ersten Sanity-Erfahrungen.

Voraussetzungen

Grundverständnis von JSON und strukturierten Inhalten; Programmiererfahrung ist hilfreich.

Seminarinhalte

1. Abfragemodell

Dieser Baustein behandelt die Aufgabe, Dataset, Dokumentstrom, Filter und Projektion als Verarbeitungsschritte verstehen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Dataset, Dokumentstrom, Filter und Projektion als Verarbeitungsschritte verstehen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Dataset, Dokumentstrom, Filter und Projektion als Verarbeitungsschritte verstehen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

2. Dokumentauswahl

Dieser Baustein behandelt die Aufgabe, Typen, Felder, definierte Werte und logische Bedingungen filtern. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Typen, Felder, definierte Werte und logische Bedingungen filtern“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Typen, Felder, definierte Werte und logische Bedingungen filtern“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

3. Sortierung und Slicing

Dieser Baustein behandelt die Aufgabe, Ergebnisreihenfolgen, Bereiche und Seitenausschnitte bestimmen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Ergebnisreihenfolgen, Bereiche und Seitenausschnitte bestimmen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Ergebnisreihenfolgen, Bereiche und Seitenausschnitte bestimmen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

4. Projektionen

Dieser Baustein behandelt die Aufgabe, benötigte Felder auswählen, umbenennen und strukturieren. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „benötigte Felder auswählen, umbenennen und strukturieren“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „benötigte Felder auswählen, umbenennen und strukturieren“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

5. Parameter

Dieser Baustein behandelt die Aufgabe, dynamische Werte sicher von der Abfragestruktur trennen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „dynamische Werte sicher von der Abfragestruktur trennen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „dynamische Werte sicher von der Abfragestruktur trennen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

6. Referenzen

Dieser Baustein behandelt die Aufgabe, verknüpfte Dokumente gezielt dereferenzieren. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „verknüpfte Dokumente gezielt dereferenzieren“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „verknüpfte Dokumente gezielt dereferenzieren“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

7. Arrays und Portable Text

Dieser Baustein behandelt die Aufgabe, Arrayinhalte, Blocktypen und eingebettete Objekte filtern. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Arrayinhalte, Blocktypen und eingebettete Objekte filtern“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Arrayinhalte, Blocktypen und eingebettete Objekte filtern“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

8. Fehleranalyse

Dieser Baustein behandelt die Aufgabe, leere Ergebnisse, undefinierte Felder und falsche Scopes systematisch diagnostizieren. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „leere Ergebnisse, undefinierte Felder und falsche Scopes systematisch diagnostizieren“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „leere Ergebnisse, undefinierte Felder und falsche Scopes systematisch diagnostizieren“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

Praxisübungen

1. Abfragen für Listen-, Detail- und Navigationsansichten erstellen.
2. Eine parametrisierte Suche mit Sortierung umsetzen.
3. Referenz- und Arrayabfragen anhand eines Beispielmodells prüfen.

Qualitätssicherung

• Jeder Arbeitsschritt wird mit einem nachvollziehbaren Soll-Ergebnis abgeschlossen.
• Konfigurationen und Implementierungen werden gegen Normal-, Grenz- und Fehlerfälle geprüft.
• Fachliche und technische Entscheidungen werden mit Annahmen und Auswirkungen dokumentiert.
• Die Abschlussprüfung bewertet Vollständigkeit, Wartbarkeit, Sicherheit und betriebliche Eignung.

Methodik

Fachliche Einordnung, Live-Demonstration, angeleitete Umsetzung, eigenständige Übungen, Review und Fehleranalyse wechseln sich ab. Der Praxisfall wächst über die einzelnen Bausteine hinweg zu einer konsistenten Gesamtlösung.