Seminar Enonic XP 8 – Anwendungsentwicklung mit TypeScript und EDK

Das Seminar führt von der Projektinitialisierung bis zur produktionsfähigen Enonic-XP-8-Anwendung. Architektur, serverseitiges TypeScript, Plattformbibliotheken, CMS-Ressourcen, Webschnittstellen und Hintergrundprozesse werden in einem konsistenten Codebestand verbunden.

Ein Fachfall wird als modulare Anwendung umgesetzt, automatisiert getestet und über eine Build-Pipeline paketiert. Besonderes Gewicht liegt auf klaren Verantwortungsgrenzen, typisierten Schnittstellen, sicherer Fehlerbehandlung und späterer Upgrade-Fähigkeit.

Inhaltsübersicht

1. Tooling, CLI und Sandbox
2. Projektstruktur und App-Lebenszyklus
3. Serverseitiges TypeScript
4. YAML-Schemas und Namespaces
5. Repository- und Node-Zugriff
6. Content- und Projektbibliotheken
7. Universal APIs
8. Sites, Seiten und Komponenten
9. Tasks, Scheduler und Events
10. Webapps und Echtzeitfunktionen
11. Sicherheitsmodell und Audit
12. Automatisierte Tests
13. Build, CI/CD und Bereitstellung

Lernziele

• EDK-Tooling, Build-System und App-Lebenszyklus beherrschen
• serverseitiges TypeScript und Plattformbibliotheken strukturiert einsetzen
• YAML-Schemas, Content- und Repository-Zugriffe implementieren
• Universal APIs, Sites und Hintergrundprozesse sicher entwickeln
• Tests, CI/CD, Paketierung und Betriebsanforderungen integrieren

Praxisorientierte Lernschritte

1. Tooling, CLI und Sandbox

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

1. Schritt 1: CLI, SDK, Sandbox und Starter für eine reproduzierbare Entwicklungsumgebung einrichten
2. Schritt 2: Projektparameter, App-Schlüssel und lokale Konfiguration nachvollziehbar festlegen
3. Schritt 3: Entwicklungsmodus, Build und Hot-Deployment mit definierten Prüfungen nutzen

2. Projektstruktur und App-Lebenszyklus

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

1. Schritt 1: Quellcode, Ressourcen, Tests und Konfiguration nach Verantwortungen organisieren
2. Schritt 2: Start-, Stopp- und Upgrade-Verhalten einer Anwendung planen
3. Schritt 3: Abhängigkeiten und öffentliche Schnittstellen in einer Architekturübersicht dokumentieren

3. Serverseitiges TypeScript

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

1. Schritt 1: Modulsystem, Typen, globale Objekte und Laufzeitgrenzen einordnen
2. Schritt 2: fachliche Services mit klaren Eingaben, Ausgaben und Fehlerklassen implementieren
3. Schritt 3: Java-Bridge und externe Bibliotheken nur an kontrollierten Integrationspunkten einsetzen

4. YAML-Schemas und Namespaces

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, Formulare und wiederverwendbare Schemaelemente modellieren
2. Schritt 2: Namespaces, Benennung, Lokalisierung und Validierung konsistent gestalten
3. Schritt 3: Schemaänderungen mit Testdaten und Migrationsbedarf bewerten

5. Repository- und Node-Zugriff

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

1. Schritt 1: Repository, Branch und Ausführungskontext explizit auswählen
2. Schritt 2: Knoten transaktional lesen, schreiben, patchen und sortieren
3. Schritt 3: Berechtigungs-, Parallelitäts- und Fehlerfälle mit reproduzierbaren Tests absichern

6. Content- und Projektbibliotheken

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-Operationen für Entwurf, Veröffentlichung und mehrere Projekte einsetzen
2. Schritt 2: Beziehungen, Medien, Sprachen und Pfade korrekt verarbeiten
3. Schritt 3: Änderungen über mehrere Branches kontrolliert planen und prüfen

7. Universal 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: API-Manifest, Namen und Mounting für den Fachfall definieren
2. Schritt 2: HTTP-Funktionen mit Validierung, Authentifizierung und konsistenten Antworten implementieren
3. Schritt 3: Fehler, Versionierung und Beobachtbarkeit als Teil des Vertrags behandeln

8. Sites, Seiten und Komponenten

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

1. Schritt 1: CMS-Ressourcen und Site-Scope für die Anwendung strukturieren
2. Schritt 2: Seiten, Parts, Layouts und Beiträge mit typisierten Konfigurationen verbinden
3. Schritt 3: Editorzustände, Vorschau und Berechtigungen im Rendering berücksichtigen

9. Tasks, Scheduler und Events

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

1. Schritt 1: lange oder wiederkehrende Arbeiten aus synchronen Requests auslagern
2. Schritt 2: Fortschritt, Wiederholung, Idempotenz und Clusterverhalten festlegen
3. Schritt 3: Ereignisse für lose Kopplung nutzen und Fehlerszenarien kontrolliert behandeln

10. Webapps und Echtzeitfunktionen

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

1. Schritt 1: eine eigenständige Webapp mit Request-, Response- und Filterlogik erstellen
2. Schritt 2: SSE oder WebSocket für einen begrenzten Echtzeitfall auswählen
3. Schritt 3: Origin-Prüfung, Sitzungen und Ressourcenbegrenzung absichern

11. Sicherheitsmodell und Audit

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

1. Schritt 1: Benutzerkontext, Rollen und Service Accounts in den Fachablauf integrieren
2. Schritt 2: jede privilegierte Operation serverseitig autorisieren
3. Schritt 3: Auditdaten, Geheimnisse und datenschutzrelevante Protokollierung definieren

12. Automatisierte Tests

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

1. Schritt 1: Unit-Tests für Fachlogik und Adapter schreiben
2. Schritt 2: Integrations- und API-Tests mit kontrollierten Datenbeständen aufbauen
3. Schritt 3: Fehlerpfade, Berechtigungswechsel und Nebenläufigkeit in die Testmatrix aufnehmen

13. Build, CI/CD und Bereitstellung

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

1. Schritt 1: Gradle-Build, Qualitätsprüfungen und Artefaktversionierung automatisieren
2. Schritt 2: Pipeline-Stufen für Test, Paketierung, Installation und Verifikation definieren
3. Schritt 3: Rollback, Kompatibilitätsprüfung und Betriebsübergabe als Release-Gates verankern

Zielgruppe und Vorkenntnisse

Zielgruppe: TypeScript- und JavaScript-Entwickler, Softwarearchitekten, Integrationsentwickler und technische Leads für Enonic-XP-Projekte.

Vorkenntnisse: Sichere Kenntnisse in TypeScript oder modernem JavaScript, HTTP, Git und automatisierten Tests; Grundverständnis von Content-Modellen, APIs und serverseitiger Entwicklung.

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.