Seminar Enonic XP 8 – Headless CMS mit Guillotine und GraphQL

Das Seminar zeigt den vollständigen Aufbau einer Headless-CMS-Lösung mit Enonic XP 8 und Guillotine. Redaktionelles Modell, GraphQL-Vertrag, Sicherheitskontext, Frontend-Abfragen und Betriebsanforderungen werden als zusammenhängende Architektur entwickelt.

Ein Content-Modell wird in Content Studio gepflegt und über eine dynamisch erzeugte GraphQL-Schnittstelle konsumiert. Abfragen, Suche, Medien, Entwurfszugriff, Caching und Fehlerfälle werden mit einem einfachen Client praktisch geprüft.

Inhaltsübersicht

1. Headless-Zielarchitektur
2. Content-Modell für APIs
3. Guillotine einrichten und Schema verstehen
4. Queries, Fragmente und Variablen
5. Suche, Filter und Query DSL
6. Medien, Rich Text und Referenzen
7. Lokalisierung und Projektkontext
8. Authentifizierung und Berechtigungen
9. Performance und Caching
10. Clientintegration, Tests und Betrieb

Lernziele

• Headless-Architektur und Verantwortungsgrenzen belastbar entwerfen
• Content-Modelle für eine klare GraphQL-Ausgabe vorbereiten
• Guillotine-Abfragen, Filter und Fragmente effizient einsetzen
• Preview, Berechtigungen, Medien und Lokalisierung integrieren
• Performance, Tests, Versionierung und Betrieb absichern

Praxisorientierte Lernschritte

1. Headless-Zielarchitektur

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Redaktion, Content-Plattform, GraphQL-Schicht und Frontend als getrennte Verantwortungen modellieren
2. Schritt 2: Draft-, Preview- und veröffentlichte Zugriffe unterscheiden
3. Schritt 3: Datenflüsse, Vertrauensgrenzen und Betriebsabhängigkeiten dokumentieren

2. Content-Modell für APIs

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Content-Typen und Beziehungen nach Frontend-Anforderungen überprüfen
2. Schritt 2: stabile Felder, IDs, Lokalisierung und Medienverweise festlegen
3. Schritt 3: ein repräsentatives Datenpaket für Abfrage- und Performancetests erstellen

3. Guillotine einrichten und Schema verstehen

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Anwendung, Site-Kontext und erforderliche Konfiguration bereitstellen
2. Schritt 2: erzeugtes GraphQL-Schema nach Typen, Feldern und Abfrageeinstiegen untersuchen
3. Schritt 3: unerwünschte oder unklare Modellbestandteile vor Cliententwicklung korrigieren

4. Queries, Fragmente und Variablen

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: kleine, zielgerichtete Abfragen mit Variablen formulieren
2. Schritt 2: wiederverwendbare Fragmente für gemeinsame Felder aufbauen
3. Schritt 3: Antwortgröße, Nullwerte und Fehlerpfade mit Testfällen kontrollieren

5. Suche, Filter und Query DSL

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: fachliche Suchfälle in Filter-, Sortier- und Paginganforderungen zerlegen
2. Schritt 2: Query-DSL-Ausdrücke sicher in GraphQL-Abfragen einbinden
3. Schritt 3: Trefferqualität und Grenzfälle mit realistischen Daten bewerten

6. Medien, Rich Text und Referenzen

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Medienmetadaten und Auslieferungsinformationen gezielt abfragen
2. Schritt 2: Rich-Text-Inhalte, interne Referenzen und eingebettete Elemente korrekt verarbeiten
3. Schritt 3: fehlende oder nicht veröffentlichte Abhängigkeiten robust behandeln

7. Lokalisierung und Projektkontext

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Sprache, Projekt und Branch explizit als Abfragekontext modellieren
2. Schritt 2: Fallback- und unvollständige Übersetzungsszenarien testen
3. Schritt 3: Frontend-Routing und Content-Pfade mit dem redaktionellen Modell abgleichen

8. Authentifizierung und Berechtigungen

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: öffentliche, benutzerbezogene und technische Zugriffe unterscheiden
2. Schritt 2: Service Account beziehungsweise Token auf minimale Rechte begrenzen
3. Schritt 3: Draft-Zugriff, Feldsichtbarkeit und unzulässige Abfragen mit Negativtests prüfen

9. Performance und Caching

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Abfrageform, Paging, Beziehungen und Antwortgröße messen
2. Schritt 2: Frontend-, Gateway- und serverseitige Cachegrenzen definieren
3. Schritt 3: Cacheinvalidierung und Publikationsereignisse in die Architektur aufnehmen

10. Clientintegration, Tests und Betrieb

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: typisierte Clientabfragen und Fehlerbehandlung implementieren
2. Schritt 2: Vertragstests für Schema, Berechtigungen und Beispielantworten automatisieren
3. Schritt 3: Monitoring, Versionsstrategie und Störungsrunbook für die Schnittstelle erstellen

Zielgruppe und Vorkenntnisse

Zielgruppe: Frontend- und Full-Stack-Entwickler, Content Architects, API-Architekten, technische Product Owner und Integrationsteams für Headless- und Composable-DXP-Projekte.

Vorkenntnisse: Gute Kenntnisse in Webentwicklung, JSON, HTTP und APIs; GraphQL-Grundkenntnisse sowie Erfahrung mit strukturierten Content-Modellen sind hilfreich.

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar durch Demonstrationen, strukturierte Konfigurations- oder Implementierungsschritte und kontrollierte Fehlerfälle vertieft. Jede Übung besitzt definierte Ausgangswerte, Prüfpunkte und Dokumentationsanforderungen. Dadurch bleiben die erarbeiteten Abläufe für Projekt- und Betriebsstandards nachvollziehbar.