Seminar Enonic XP 8 – Content-Modellierung mit YAML-Schemas

Das Seminar zeigt, wie fachliche Informationsmodelle in wartbare YAML-Schemas für Enonic XP 8 überführt werden. Neben der technischen Syntax stehen Verständlichkeit, redaktionelle Bedienbarkeit, Suchbarkeit, Versionierung und langfristige Änderbarkeit im Vordergrund.

Ein mehrteiliges Domänenmodell wird schrittweise analysiert, implementiert und in Content Studio abgenommen. Bewusste Schemaänderungen verdeutlichen Auswirkungen auf bestehende Inhalte, APIs, Suche und Migration.

Inhaltsübersicht

1. Domänenanalyse und Modellgrenzen
2. Namespaces und Ressourcenstruktur
3. Content-Typen und Eigenschaften
4. Form Items und Editorführung
5. Validierung und fachliche Regeln
6. Form Fragments und Mixins
7. Beziehungen und Referenzmodelle
8. Lokalisierung und mehrsprachige Felder
9. Indexierung und Suchbarkeit
10. Versionierung, Migration und Abnahme

Lernziele

• Domänenanforderungen in stabile Content-Typen und Beziehungen übersetzen
• YAML-Schemas, Namespaces und Formulare konsistent strukturieren
• Validierung, Wiederverwendung und Lokalisierung zielgerichtet einsetzen
• Indexierung und API-Ausgabe bereits im Modell berücksichtigen
• Schemaänderungen versionieren, testen und migrieren

Praxisorientierte Lernschritte

1. Domänenanalyse und Modellgrenzen

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

1. Schritt 1: Fachbegriffe, Entitäten, Lebenszyklen und Verantwortlichkeiten erfassen
2. Schritt 2: strukturierte Inhalte, Medien, Seiten und technische Daten voneinander trennen
3. Schritt 3: Modellziele und bewusst ausgeschlossene Anforderungen dokumentieren

2. Namespaces und Ressourcenstruktur

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

1. Schritt 1: Namespaces und Benennung für projektweite Eindeutigkeit festlegen
2. Schritt 2: Schemaressourcen nach Typ und Verantwortungsbereich organisieren
3. Schritt 3: Abhängigkeiten zwischen App, Schema und Nutzungskontext sichtbar machen

3. Content-Typen und Eigenschaften

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

1. Schritt 1: Eigenschaften nach Fachbedeutung, Datentyp und Kardinalität definieren
2. Schritt 2: Pflicht, Wiederholung und Standardwerte bewusst einsetzen
3. Schritt 3: ein erstes Content-Schema bauen und mit repräsentativen Daten prüfen

4. Form Items und Editorführung

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

1. Schritt 1: geeignete Eingabetypen für Text, Auswahl, Datum, Referenz und Medien wählen
2. Schritt 2: Feldgruppen, Hilfetexte und Reihenfolge für einen klaren Bearbeitungsfluss gestalten
3. Schritt 3: Validierungs- und Bedienungsprobleme mit Redaktionsaufgaben testen

5. Validierung und fachliche Regeln

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

1. Schritt 1: Format-, Werte- und Kardinalitätsregeln im Schema abbilden
2. Schritt 2: komplexere fachliche Prüfungen an geeignete Erweiterungspunkte auslagern
3. Schritt 3: Fehlermeldungen so gestalten, dass Korrekturen eindeutig möglich sind

6. Form Fragments und Mixins

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

1. Schritt 1: wiederkehrende Formularteile identifizieren und als Fragmente kapseln
2. Schritt 2: querschnittliche Zusatzdaten über Mixins modellieren
3. Schritt 3: Wiederverwendung gegen unerwünschte Kopplung und Änderungsfolgen abwägen

7. Beziehungen und Referenzmodelle

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

1. Schritt 1: Einbettung, Content-Referenz und fachliche ID als Alternativen vergleichen
2. Schritt 2: Auswahlregeln und erlaubte Zieltypen begrenzen
3. Schritt 3: Löschung, Verschiebung und fehlende Referenzen in der Testmatrix berücksichtigen

8. Lokalisierung und mehrsprachige Felder

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

1. Schritt 1: sprachabhängige und sprachneutrale Eigenschaften unterscheiden
2. Schritt 2: Übersetzungsbedarf, Fallback und regionale Varianten modellieren
3. Schritt 3: mehrsprachige Beispieldaten in Editor, API und Suche kontrollieren

9. Indexierung und Suchbarkeit

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

1. Schritt 1: relevante Felder, Volltext und sprachbezogene Analyse festlegen
2. Schritt 2: Such- und Filteranforderungen gegen das Modell prüfen
3. Schritt 3: Indexwirkung mit Testabfragen und repräsentativen Daten bewerten

10. Versionierung, Migration und Abnahme

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

1. Schritt 1: breaking und nicht breaking Schemaänderungen unterscheiden
2. Schritt 2: Migrationsskript, Rückfalloption und Datenprüfung planen
3. Schritt 3: technische Tests und redaktionelle Abnahme zu einem Freigabeverfahren verbinden

Zielgruppe und Vorkenntnisse

Zielgruppe: Content Architects, Informationsarchitekten, Enonic-Entwickler, technische Product Owner, Integrationsentwickler und erfahrene Content Manager.

Vorkenntnisse: Grundkenntnisse in Enonic XP, strukturierten Datenmodellen und YAML; für praktische Übungen sind grundlegende Git- und Entwicklungskenntnisse erforderlich.

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.