Seminar Enonic XP 8 – Integration externer Systeme und Datenimporte

Das Seminar behandelt Integrationen nicht als einmalige Skripte, sondern als dauerhaft betreibbare Datenprodukte. Verträge, Identitäten, Wiederholbarkeit, Fehlerpfade, Beobachtbarkeit und fachliche Abnahme werden gleichwertig mit der eigentlichen Datenübertragung geplant.

Ein externer Datenbestand wird über eine definierte Schnittstelle in Enonic XP 8 übernommen und anschließend inkrementell aktualisiert. Fehlerhafte Datensätze, Medien, Doppellieferungen, Abbrüche und Wiederanlauf werden gezielt simuliert.

Inhaltsübersicht

1. Integrationsziele und Systemgrenzen
2. Datenvertrag und Mapping
3. Universal API für Integrationen
4. Technische Identitäten und Geheimnisse
5. Vollimport und Datenanlage
6. Delta-Import und Idempotenz
7. Medien und große Payloads
8. Transaktionen und Fehlerbehandlung
9. Tasks, Scheduler und Monitoring
10. Test, Cutover und Betriebsübergabe

Lernziele

• Integrationsarchitektur und Datenverträge eindeutig festlegen
• Universal APIs und Service Accounts sicher einsetzen
• Batch- und Delta-Importe idempotent implementieren
• Mapping, Medien und Fehlerbehandlung kontrolliert gestalten
• Scheduling, Monitoring, Tests und Cutover operationalisieren

Praxisorientierte Lernschritte

1. Integrationsziele und Systemgrenzen

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

1. Schritt 1: führende Systeme, Eigentümer, Aktualisierungsrichtung und Fachziele erfassen
2. Schritt 2: synchronen API-Zugriff, Batch-Import und Ereignisverarbeitung vergleichen
3. Schritt 3: eine Zielarchitektur mit Vertrauens- und Fehlergrenzen dokumentieren

2. Datenvertrag und Mapping

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

1. Schritt 1: Quellfelder, Zielmodell, IDs, Kardinalitäten und Pflichtwerte zuordnen
2. Schritt 2: Datentypen, Zeitzonen, Sprachen und Referenzen explizit festlegen
3. Schritt 3: Vertrag mit gültigen, unvollständigen und widersprüchlichen Beispielen prüfen

3. Universal API für Integrationen

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

1. Schritt 1: Eingangs- oder Ausgangs-API mit eindeutigem Namen und Mounting definieren
2. Schritt 2: Validierung, Statuscodes, Fehlerformat und Versionskennzeichnung implementieren
3. Schritt 3: Request-Größen, Zeitlimits und wiederholte Aufrufe begrenzen

4. Technische Identitäten und Geheimnisse

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

1. Schritt 1: Service Account nach Integrationszweck und minimaler Berechtigung anlegen
2. Schritt 2: Token, Zertifikate oder Schlüssel außerhalb des Codes bereitstellen
3. Schritt 3: Rotation, Widerruf und Fehlversuche in den Betriebsprozess aufnehmen

5. Vollimport und Datenanlage

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

1. Schritt 1: Importreihenfolge nach Abhängigkeiten und Referenzen festlegen
2. Schritt 2: Daten in kontrollierten Batches validieren, transformieren und schreiben
3. Schritt 3: Fortschritt, Laufzeit und fachliche Summen nach jedem Batch prüfen

6. Delta-Import und Idempotenz

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

1. Schritt 1: Änderungsmarker, Zeitstempel oder Quellversion als Delta-Strategie auswählen
2. Schritt 2: Wiederholung desselben Datensatzes ohne unerwünschte Nebenwirkungen sicherstellen
3. Schritt 3: Löschungen, Deaktivierungen und verspätete Ereignisse eindeutig behandeln

7. Medien und große Payloads

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

1. Schritt 1: Metadaten- und Binärübertragung voneinander trennen
2. Schritt 2: Dateityp, Größe, Prüfsumme und Dubletten vor Übernahme kontrollieren
3. Schritt 3: abgebrochene oder teilweise Medienübertragungen wiederaufnehmbar gestalten

8. Transaktionen und Fehlerbehandlung

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

1. Schritt 1: atomare Einheit und akzeptable Teilverarbeitung fachlich festlegen
2. Schritt 2: Fehler klassifizieren, isolieren und mit Wiederholstrategie versehen
3. Schritt 3: Dead-Letter-Bestand und manuelle Korrektur mit Auditspur organisieren

9. Tasks, Scheduler und Monitoring

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 Läufe als Tasks mit Fortschritt und Abbruchmöglichkeit ausführen
2. Schritt 2: Zeitpläne, Sperren und parallele Läufe kontrollieren
3. Schritt 3: Metriken, Logs und Alarmierung für Durchsatz, Fehler und Datenalter einrichten

10. Test, Cutover und Betriebsübergabe

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

1. Schritt 1: Vertrags-, Mapping-, Last- und Wiederanlauftests automatisieren
2. Schritt 2: Probeübernahme und fachlichen Vergleich mit Freigabekriterien durchführen
3. Schritt 3: Cutover, Rückfall, Verantwortlichkeiten und Support-Runbook dokumentieren

Zielgruppe und Vorkenntnisse

Zielgruppe: Integrationsentwickler, Enonic-Entwickler, Datenarchitekten, technische Product Owner, ETL-Verantwortliche und DevOps-nahe Betriebsteams.

Vorkenntnisse: Sichere Kenntnisse in TypeScript oder vergleichbarer Backend-Entwicklung, HTTP und JSON sowie Grundkenntnisse in Enonic Content- und Node-Bibliotheken und Datenmodellierung.

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.