Seminar Jahia DXP Headless, GraphQL und API-Entwicklung

Headless-Projekte sind nur dann flexibel, wenn Inhaltsmodell, Berechtigungen, API-Vertrag und Frontend gemeinsam entworfen werden. Die Teilnehmer entwickeln eine robuste Zugriffsschicht, testen sie im integrierten Werkzeug und binden sie in eine moderne Anwendung ein.

Ihr Nutzen

• Sie formulieren effiziente GraphQL-Abfragen für Seiten, strukturierte Inhalte, Medien, Referenzen und Listen.
• Sie führen kontrollierte Mutationen aus und berücksichtigen Arbeitsbereiche, Sprachen und Berechtigungen.
• Sie entwickeln ein eigenes Schema mit SDL und verbinden es korrekt mit dem Jahia-Inhaltsmodell.
• Sie integrieren Clients mit Authentifizierung, Fehlerbehandlung, Caching und nachvollziehbaren API-Verträgen.
• Sie schützen Schnittstellen mit Tokens, Scopes, CORS-Regeln und geeigneten Betriebsgrenzen.

Zielgruppe

Das Seminar richtet sich an Entwickler und Architekten, die React-, Next.js-, Vue-, Mobile- oder andere entkoppelte Anwendungen auf Jahia aufbauen. Auch Integrationsteams profitieren, wenn GraphQL als fachliche Zugriffsschicht zwischen Content-Plattform und weiteren Kanälen eingesetzt werden soll.

Voraussetzungen

Erforderlich sind praktische Kenntnisse in HTTP, JSON und einer Programmiersprache. Die Teilnehmer sollten grundlegende GraphQL-Begriffe wie Schema, Query, Mutation, Fragment und Variable kennen. Jahia-Content-Modellierung wird eingeordnet, aber nicht von Grund auf vollständig behandelt.

Inhalte

Die Themen werden anhand eines durchgängigen Praxisfalls erarbeitet und jeweils mit fachlichen, technischen und organisatorischen Entscheidungen verbunden.

Tag 1: Jahia-Inhalte sicher abfragen

• GraphQL-Werkzeuge, Schemaerkennung, JCR-Abbildung und zentrale Abfrageobjekte
• Queries, Variablen, Fragmente, Aliase, Filter, Sortierung, Pagination und Sprachkontext
• Seiten, strukturierte Inhalte, Medien, Referenzen und verschachtelte Daten effizient lesen
• Rechte, Arbeitsbereiche, Veröffentlichungsstatus und reproduzierbare Testabfragen
• Aufbau eines dokumentierten Query-Satzes für eine Beispielanwendung

Tag 2: Mutationen und eigenes Schema

• Erstellen, Ändern und Löschen von Inhalten mit kontrollierten Mutationen
• Authentifizierung, JWT, Benutzerkontext, technische Konten und minimale Berechtigungen
• SDL-Dateien, eigene Typen, Query-Erweiterungen und Zuordnung zu Content-Eigenschaften
• Validierung, Fehlermeldungen, Transaktionen und stabile API-Verträge
• Praktische Erweiterung des Schemas für einen fachlichen Anwendungsfall

Tag 3: Client-Integration, Betrieb und Personalisierung

• Integration mit Apollo oder vergleichbaren Clients, Caching und Zustandsmanagement
• Serverseitige und clientseitige Zugriffe, Timeouts, Wiederholungen und strukturierte Fehlerbehandlung
• CORS, Security Filter, Token-Scopes, Schutz sensibler Felder und API-Beobachtbarkeit
• Personalisierte Ausgaben im headless Kontext sowie Weitergabe von Session- und Profilinformationen
• Abschlussübung: kleine headless Anwendung mit Query, Mutation, eigenem Schema und Sicherheitsprüfung

Praxis und Arbeitsweise

Die Teilnehmer arbeiten mit dem integrierten GraphQL-Werkzeug und einem kleinen Clientprojekt. Sie entwickeln Abfragen, eine Mutation und eine Schemaerweiterung und prüfen anschließend Rechte, Fehlerverhalten und Caching.