Seminar Payload CMS – Import, Export und Datenübernahme

Das Fachseminar vermittelt die fachlichen und technischen Kompetenzen für eine planbare, wartbare und überprüfbare Umsetzung. Der Schwerpunkt liegt auf der kontrollierten Übernahme, Transformation, Prüfung und revisionsfähigen Abnahme von Inhalts- und Mediendaten. Die Inhalte werden an einem durchgängigen Beispielprojekt erarbeitet und in nachvollziehbaren Arbeitsschritten umgesetzt.

Das Seminar entwickelt einen wiederanlaufbaren Migrationsprozess von der Quellanalyse bis zur Abnahme. Mapping, Bereinigung, Identitäten, Beziehungen, Medien, Batchverarbeitung, Fehlerlisten, Validierung, Deltaübernahme und sichere Rückfallpunkte werden praktisch umgesetzt.

Inhaltsübersicht

• Einordnung und Zielbild
• Kompetenzziele
• Zielgruppe und Voraussetzungen
• Schrittweise Seminarinhalte
• Praxisübungen
• Lernkontrolle und Dokumentation

Einordnung und Zielbild

Die gewählte Dauer von 2 Tagen ermöglicht eine belastbare Verbindung aus Konzeptklärung, Demonstration, angeleiteter Umsetzung, eigenständiger Übung und strukturierter Qualitätskontrolle.

Zu Beginn werden Zielarchitektur, Verantwortlichkeiten und Abgrenzungen geklärt. Darauf folgen die fachliche Modellierung, die technische Umsetzung, die Überprüfung typischer Fehlerbilder und die Überführung in eine dokumentierte Projektkonvention.

Kompetenzziele

• Quellbestände und Datenqualität systematisch analysieren.
• Feld-, Wert- und Beziehungs-Mappings eindeutig dokumentieren.
• Importe wiederanlaufbar, idempotent und protokolliert implementieren.
• Medien und Referenzen konsistent übernehmen.
• Vollständigkeit und fachliche Qualität mit quantitativen Kontrollen abnehmen.

Zielgruppe und Voraussetzungen

Zielgruppe: Datenmigrationsteams, Backend-Entwicklung, technische Redaktion, Anwendungsbetreuung, Datenverantwortung und Projektleitung.

Voraussetzungen: Payload-Grundkenntnisse, Basiswissen zu CSV oder JSON, Datenmodellen und Skripting. Für Programmierübungen sind TypeScript-Kenntnisse erforderlich.

Schrittweise Seminarinhalte

1. Quelleninventar und Datenprofil

Vor jeder Transformation werden Umfang, Struktur, Qualität und Verantwortung der Quelldaten transparent gemacht.

Kapitelinhaltsverzeichnis

• Schritt 1: Quellen, Formate, Datenmengen und Aktualisierungszeitpunkte erfassen.
• Schritt 2: Pflichtwerte, Schlüssel, Dubletten und ungültige Formate profilieren.
• Schritt 3: Führende Quelle und Konfliktregel je Datenbereich festlegen.
• Schritt 4: Schutzbedürftige und nicht zu übernehmende Daten markieren.
• Schritt 5: Befunde in einem priorisierten Datenqualitätsbericht dokumentieren.
• Praxisauftrag

1. Schritt 1: Quellen, Formate, Datenmengen und Aktualisierungszeitpunkte erfassen.
2. Schritt 2: Pflichtwerte, Schlüssel, Dubletten und ungültige Formate profilieren.
3. Schritt 3: Führende Quelle und Konfliktregel je Datenbereich festlegen.
4. Schritt 4: Schutzbedürftige und nicht zu übernehmende Daten markieren.
5. Schritt 5: Befunde in einem priorisierten Datenqualitätsbericht dokumentieren.

Praxisauftrag: Ein Beispielbestand wird profiliert und mit Qualitätskennzahlen sowie Migrationsrisiken beschrieben.

2. Mapping und Transformationsregeln

Ein explizites Mapping verhindert, dass technische Feldzuordnungen unbemerkt fachliche Bedeutungen verändern.

Kapitelinhaltsverzeichnis

• Schritt 1: Quell- und Zielfelder mit Datentyp, Pflichtstatus und Bedeutung gegenüberstellen.
• Schritt 2: Wertelisten, Einheiten, Datumsformate und Statuswerte normalisieren.
• Schritt 3: Standardwerte, Ableitungen und bewusste Nichtübernahmen definieren.
• Schritt 4: Fehlende oder mehrdeutige Werte in Fehlerklassen einordnen.
• Schritt 5: Mapping mit repräsentativen Beispieldatensätzen reviewen.
• Praxisauftrag

1. Schritt 1: Quell- und Zielfelder mit Datentyp, Pflichtstatus und Bedeutung gegenüberstellen.
2. Schritt 2: Wertelisten, Einheiten, Datumsformate und Statuswerte normalisieren.
3. Schritt 3: Standardwerte, Ableitungen und bewusste Nichtübernahmen definieren.
4. Schritt 4: Fehlende oder mehrdeutige Werte in Fehlerklassen einordnen.
5. Schritt 5: Mapping mit repräsentativen Beispieldatensätzen reviewen.

Praxisauftrag: Ein vollständiges Feld- und Wertemapping wird erstellt und anhand von Grenzfällen geprüft.

3. Identitäten, Dubletten und Beziehungen

Stabile externe Schlüssel und kontrollierte Zuordnung sind Voraussetzung für Wiederanlauf und Referenzintegrität.

Kapitelinhaltsverzeichnis

• Schritt 1: Externe Identitäten und eindeutige Zielschlüssel festlegen.
• Schritt 2: Dublettenregeln nach automatischer, manueller und nicht zulässiger Zusammenführung gliedern.
• Schritt 3: Abhängige Objekte in einer geeigneten Reihenfolge importieren.
• Schritt 4: Alte und neue IDs in einer Zuordnungstabelle führen.
• Schritt 5: Fehlende oder zyklische Beziehungen getrennt behandeln.
• Praxisauftrag

1. Schritt 1: Externe Identitäten und eindeutige Zielschlüssel festlegen.
2. Schritt 2: Dublettenregeln nach automatischer, manueller und nicht zulässiger Zusammenführung gliedern.
3. Schritt 3: Abhängige Objekte in einer geeigneten Reihenfolge importieren.
4. Schritt 4: Alte und neue IDs in einer Zuordnungstabelle führen.
5. Schritt 5: Fehlende oder zyklische Beziehungen getrennt behandeln.

Praxisauftrag: Personen, Kategorien und Beiträge werden mit ID-Mapping, Dublettenregel und Referenzprüfung vorbereitet.

4. Wiederanlaufbarer Batchimport

Große Bestände werden in kontrollierbare Einheiten zerlegt und ohne doppelte Datensätze wiederholbar verarbeitet.

Kapitelinhaltsverzeichnis

• Schritt 1: Batchgröße, Sortierung und sicheren Fortsetzungspunkt festlegen.
• Schritt 2: Create-, Update- und Skip-Entscheidung aus dem externen Schlüssel ableiten.
• Schritt 3: Jeden Datensatz mit Status, Fehler und Ziel-ID protokollieren.
• Schritt 4: Temporäre Fehler wiederholen und dauerhafte Fehler separat ausgeben.
• Schritt 5: Abbruch und Neustart ab einem kontrollierten Checkpoint testen.
• Praxisauftrag

1. Schritt 1: Batchgröße, Sortierung und sicheren Fortsetzungspunkt festlegen.
2. Schritt 2: Create-, Update- und Skip-Entscheidung aus dem externen Schlüssel ableiten.
3. Schritt 3: Jeden Datensatz mit Status, Fehler und Ziel-ID protokollieren.
4. Schritt 4: Temporäre Fehler wiederholen und dauerhafte Fehler separat ausgeben.
5. Schritt 5: Abbruch und Neustart ab einem kontrollierten Checkpoint testen.

Praxisauftrag: Ein idempotenter Importer verarbeitet mehrere Batches, wird absichtlich unterbrochen und ohne Doppelanlage fortgesetzt.

5. Medienübernahme

Dateien und Metadaten werden so migriert, dass Referenzen, Dateitypen und Wiederherstellbarkeit erhalten bleiben.

Kapitelinhaltsverzeichnis

• Schritt 1: Quelldateien, Pfade, Metadaten und Verwendungsstellen inventarisieren.
• Schritt 2: Dateinamen, Typen, Größen und Prüfsummen validieren.
• Schritt 3: Uploadobjekte vor referenzierenden Inhalten anlegen.
• Schritt 4: Fehlende, doppelte und beschädigte Dateien protokollieren.
• Schritt 5: Stichproben von Dateiinhalt, Metadaten und Zielreferenz prüfen.
• Praxisauftrag

1. Schritt 1: Quelldateien, Pfade, Metadaten und Verwendungsstellen inventarisieren.
2. Schritt 2: Dateinamen, Typen, Größen und Prüfsummen validieren.
3. Schritt 3: Uploadobjekte vor referenzierenden Inhalten anlegen.
4. Schritt 4: Fehlende, doppelte und beschädigte Dateien protokollieren.
5. Schritt 5: Stichproben von Dateiinhalt, Metadaten und Zielreferenz prüfen.

Praxisauftrag: Ein Medienbestand wird mit Prüfsummen, Metadaten und referenzierenden Dokumenten konsistent importiert.

6. Validierung und Abnahme

Die Abnahme kombiniert Mengenabgleich, Regelprüfungen, Referenzkontrollen und fachliche Stichproben.

Kapitelinhaltsverzeichnis

• Schritt 1: Erwartete Mengen nach Objekttyp und Status definieren.
• Schritt 2: Pflicht-, Eindeutigkeits- und Referenzprüfungen automatisieren.
• Schritt 3: Summen und Verteilungen zwischen Quelle und Ziel vergleichen.
• Schritt 4: Fachliche Stichproben nach Risiko auswählen und dokumentieren.
• Schritt 5: Abweichungen mit Entscheidung, Nacharbeit und Freigabe nachhalten.
• Praxisauftrag

1. Schritt 1: Erwartete Mengen nach Objekttyp und Status definieren.
2. Schritt 2: Pflicht-, Eindeutigkeits- und Referenzprüfungen automatisieren.
3. Schritt 3: Summen und Verteilungen zwischen Quelle und Ziel vergleichen.
4. Schritt 4: Fachliche Stichproben nach Risiko auswählen und dokumentieren.
5. Schritt 5: Abweichungen mit Entscheidung, Nacharbeit und Freigabe nachhalten.

Praxisauftrag: Ein Migrationsabnahmeprotokoll wird aus automatischen Kennzahlen und fachlichen Stichproben erstellt.

7. Deltaübernahme und Umschaltung

Zwischen Generalprobe und Produktivumschaltung entstandene Änderungen werden kontrolliert nachgezogen.

Kapitelinhaltsverzeichnis

• Schritt 1: Änderungserkennung nach Zeitstempel, Version oder Quellprotokoll auswählen.
• Schritt 2: Erstübernahme und Delta mit denselben Mappingregeln ausführen.
• Schritt 3: Schreibstopp, letzte Synchronisation und Umschaltreihenfolge planen.
• Schritt 4: Rückfallpunkt und Verantwortlichkeiten für Abbruch festlegen.
• Schritt 5: Nach Umschaltung kritische Mengen und Prozesse erneut prüfen.
• Praxisauftrag

1. Schritt 1: Änderungserkennung nach Zeitstempel, Version oder Quellprotokoll auswählen.
2. Schritt 2: Erstübernahme und Delta mit denselben Mappingregeln ausführen.
3. Schritt 3: Schreibstopp, letzte Synchronisation und Umschaltreihenfolge planen.
4. Schritt 4: Rückfallpunkt und Verantwortlichkeiten für Abbruch festlegen.
5. Schritt 5: Nach Umschaltung kritische Mengen und Prozesse erneut prüfen.

Praxisauftrag: Eine Deltaübernahme und ein detaillierter Umschaltplan mit Abbruchkriterien werden vorbereitet.

Praxisübungen

• Datenprofil und Qualitätsbericht
• Feld-, Werte- und ID-Mapping
• Idempotenter Batchimport
• Medien- und Referenzmigration
• Migrationsabnahme und Delta-Umschaltung

Die Übungen werden mit klaren Eingangsdaten, Prüfkriterien und dokumentierten Soll-Ergebnissen durchgeführt. Fehler werden nicht nur korrigiert, sondern anhand ihrer Ursache, Auswirkung und geeigneten Präventionsmaßnahme eingeordnet.

Lernkontrolle und Dokumentation

Die Lernkontrolle verbindet kurze Verständnisfragen, Konfigurationsprüfungen, Code- oder Modellreviews und eine abschließende Transferaufgabe. Entscheidend ist die nachvollziehbare Begründung der gewählten Lösung.

• Abgleich der Umsetzung mit den fachlichen Akzeptanzkriterien
• Prüfung von Berechtigungen, Validierung, Fehlerbehandlung und Wartbarkeit
• Dokumentation der zentralen Entscheidungen und Betriebsannahmen
• Festhalten offener Risiken und der nächsten Umsetzungsschritte
• Erstellung einer wiederverwendbaren Checkliste für das eigene Projekt