Seminar DatoCMS: Migration und Content-Import

Migration wird als kontrollierter Datenprozess mit Inventur, Mapping, Bereinigung, Identitäten, Beziehungen, Assets, Structured Text, Testläufen, Validierung, Cutover und Rückfall behandelt. Das Ergebnis ist kein einmaliges Skript, sondern ein wiederholbarer und prüfbarer Migrationslauf.

Inhaltsübersicht

Kapitelinhaltsverzeichnis

• Lernziele und Einsatzbereiche
• Vorbereitung und Arbeitsweise
• Seminarinhalte
• Praktische Übungen und Anwendung

Lernziele und Einsatzbereiche

Kapitelinhaltsverzeichnis

• Kompetenzziele
• Typische Einsatzszenarien
• Abgrenzung und Schwerpunkt

Kompetenzziele

Die Inhalte sind auf unmittelbar anwendbare, prüfbare Kompetenzen ausgerichtet.

• Quellbestand und Datenqualität messbar analysieren.
• Mapping für Modelle, Felder, Locales, Beziehungen und Assets erstellen.
• Idempotente, fortsetzbare Importläufe mit Checkpoints implementieren.
• Vollständigkeit, fachliche Qualität und Cutover mit belastbaren Nachweisen steuern.

Typische Einsatzszenarien

Das Seminar eignet sich insbesondere für die folgenden Projekt- und Betriebssituationen.

• Ablösung eines bestehenden CMS.
• Konsolidierung mehrerer Inhaltsquellen.
• Wiederholter Produkt- oder Katalogimport vor dem Go-live.

Abgrenzung und Schwerpunkt

Die fachliche Tiefe wird durch folgende Grenzen bewusst fokussiert.

• Keine pauschale Datenbereinigung ohne fachliche Verantwortliche.
• Das Seminar ersetzt keine individuelle Migrationsanalyse großer Altsysteme.
• Quellsystemspezifische APIs werden als austauschbare Adapter behandelt.

Vorbereitung und Arbeitsweise

Kapitelinhaltsverzeichnis

• Zielgruppen
• Vorkenntnisse und Schulungsumgebung
• Didaktisches Vorgehen
• Qualitäts- und Abnahmekriterien

Zielgruppen

Datenmigration, Backend-Entwicklung, Content Operations, technische Projektleitung, Informationsarchitektur und Qualitätssicherung.

Vorkenntnisse und Schulungsumgebung

Grundkenntnisse der DatoCMS Content Management API, strukturierter Datenformate und Datenbereinigung. Ein repräsentativer Export des Quellsystems ist erforderlich.

1. Schritt 1: Zugänge, Rollen und Schulungsprojekt vor Seminarbeginn kontrollieren.
2. Schritt 2: Beispieldaten, Assets, Quellmaterial oder Codebasis entsprechend dem Seminarthema bereitstellen.
3. Schritt 3: Ausgangszustand dokumentieren, damit Übungen wiederholt und Abweichungen eindeutig bewertet werden können.

Didaktisches Vorgehen

Kurze Fachblöcke werden unmittelbar mit Demonstrationen, geführten Arbeitsschritten, eigenständigen Laborphasen und kontrollierten Fehlerfällen verbunden.

1. Schritt 1: Ausgangsproblem und gewünschtes Sollverhalten präzisieren.
2. Schritt 2: Konfiguration oder Implementierung in kleinen, überprüfbaren Schritten ausführen.
3. Schritt 3: Normalfall, Grenzfall und mindestens einen Fehlerfall testen.
4. Schritt 4: Nachweis, Betriebsregel oder Checkliste aus dem Übungsergebnis ableiten.

Qualitäts- und Abnahmekriterien

• Konfigurationen und Arbeitsschritte sind reproduzierbar dokumentiert.
• Berechtigungen, Datenstände und Environments sind eindeutig voneinander getrennt.
• Positive und negative Testfälle besitzen ein erwartetes und nachvollziehbares Ergebnis.
• Fehlerzustände führen zu einer kontrollierten Diagnose und einem definierten Wiederanlauf.

Seminarinhalte

Kapitelinhaltsverzeichnis

• Quellinventur und Datenprofiling
• Zielmodell und Mapping
• Externe IDs und Referenzen
• Reihenfolge und Beziehungen
• Locales und Inhaltsvarianten
• Assets und Dateiverarbeitung
• Structured Text und Blocktransformation
• Idempotenter Import und Checkpoints
• Validierung und Abgleich
• Cutover und Rollback

Quellinventur und Datenprofiling

Umfang, Typen, Dubletten, leere Werte und Sonderfälle werden vor der Zielmodellierung quantifiziert.

1. Schritt 1: Quellen, Tabellen, Dateien und Medienbestände erfassen.
2. Schritt 2: Stichprobe und automatisierte Profilingkennzahlen erzeugen.
3. Schritt 3: Fehlerklassen, Owner und Bereinigungsentscheidung dokumentieren.

Zielmodell und Mapping

Jedes Quellfeld erhält eine begründete Zielzuordnung oder bewusste Ausschlussentscheidung.

1. Schritt 1: Zielmodelle und Pflichtfelder bestätigen.
2. Schritt 2: Mappingtabelle mit Transformation und Standardwert erstellen.
3. Schritt 3: Nicht abbildbare Inhalte und manuelle Nacharbeit markieren.

Externe IDs und Referenzen

Stabile externe Schlüssel sichern Wiederholbarkeit und Beziehungspflege.

1. Schritt 1: Eindeutigen Schlüssel je Quellobjekt bestimmen.
2. Schritt 2: Quell-zu-Ziel-ID-Tabelle oder Lookup-Strategie anlegen.
3. Schritt 3: Dubletten und kollidierende Schlüssel vor dem Schreiben behandeln.

Reihenfolge und Beziehungen

Abhängige Records werden in Phasen importiert, damit Links und Referenzen vollständig aufgelöst werden.

1. Schritt 1: Abhängigkeitsgraph der Modelle erstellen.
2. Schritt 2: Stammdaten vor transaktionalen beziehungsweise verknüpften Inhalten importieren.
3. Schritt 3: Nicht aufgelöste Beziehungen in eine kontrollierte Fehlerliste schreiben.

Locales und Inhaltsvarianten

Mehrsprachige Werte werden normalisiert und mit einer klaren Fallback- oder Ausschlussregel übernommen.

1. Schritt 1: Quellsprachen und Ziel-Locales zuordnen.
2. Schritt 2: Leere, gemischte und falsch codierte Werte bereinigen.
3. Schritt 3: Vollständigkeit pro Locale nach dem Import prüfen.

Assets und Dateiverarbeitung

Dateien, Metadaten und Verwendungsstellen werden dedupliziert und wiederanlaufbar übertragen.

1. Schritt 1: Dateien über Hash, Pfad oder Quell-ID identifizieren.
2. Schritt 2: Upload mit begrenzter Parallelität und Statusspeicher ausführen.
3. Schritt 3: Asset-Referenzen, Alt-Texte und Fehlerfälle nachpflegen.

Structured Text und Blocktransformation

HTML, modulare Altstrukturen oder Rich Text werden in ein definiertes DAST- und Blockmodell überführt.

1. Schritt 1: Erlaubte Quellknoten und Zielknoten inventarisieren.
2. Schritt 2: Transformation mit expliziten Regeln und Fallback implementieren.
3. Schritt 3: Verschachtelung, Links, Blocks und unbekannte Elemente testen.

Idempotenter Import und Checkpoints

Jeder Lauf kann sicher wiederholt oder nach Unterbrechung fortgesetzt werden.

1. Schritt 1: Importphasen, Batchgröße und Checkpointdaten definieren.
2. Schritt 2: Create-versus-Update-Entscheidung anhand externer IDs implementieren.
3. Schritt 3: Abbruch, Wiederanlauf und zweiten Gesamtlauf testen.

Validierung und Abgleich

Technische Zählwerte und fachliche Stichproben werden gemeinsam zur Abnahme verwendet.

1. Schritt 1: Sollzahlen und Pflichtprüfungen pro Modell festlegen.
2. Schritt 2: Automatisierten Quell-Ziel-Abgleich ausführen.
3. Schritt 3: Fachliche Stichprobe mit dokumentierten Akzeptanzgrenzen durchführen.

Cutover und Rollback

Der finale Lauf wird mit Freeze, Delta, Veröffentlichung, Frontendtest und Rückfallpunkt geplant.

1. Schritt 1: Freeze- und Delta-Strategie mit Verantwortlichen festlegen.
2. Schritt 2: Generalprobe aus aktuellem Export durchführen.
3. Schritt 3: Cutover, Smoke-Test und Rückfallentscheidung nach Checkliste ausführen.

Praktische Übungen und Anwendung

Kapitelinhaltsverzeichnis

• Mehrphasiger Artikelimport
• Rich-Text-Transformation
• Asset-Import mit Deduplizierung
• Cutover-Generalprobe
• Prüf- und Abnahmekriterien

Mehrphasiger Artikelimport

Szenario: Autoren, Kategorien und Artikel mit zwei Locales und Beziehungen werden aus einer Quelle übernommen.

1. Schritt 1: Mapping und Abhängigkeitsreihenfolge erstellen.
2. Schritt 2: Stammdaten und ID-Lookups importieren.
3. Schritt 3: Artikel und Beziehungen schreiben.
4. Schritt 4: Zählwerte, Locales und Fehlerliste prüfen.

Prüfkriterium: Alle Beziehungen sind aufgelöst; Wiederholung erzeugt keine Dubletten und unvollständige Datensätze bleiben nachvollziehbar isoliert.

Rich-Text-Transformation

Szenario: HTML mit Überschriften, Listen, Links, Bildern und Sondermarkup soll in Structured Text überführt werden.

1. Schritt 1: Quellknoten inventarisieren und Zielregeln festlegen.
2. Schritt 2: Transformer für Standardknoten implementieren.
3. Schritt 3: Sonderfälle und unbekannte Elemente testen.
4. Schritt 4: Gerendertes Ergebnis fachlich abnehmen.

Prüfkriterium: Erlaubte Strukturen werden korrekt transformiert; unbekannte Elemente landen in einer geprüften Fallbackbehandlung.

Asset-Import mit Deduplizierung

Szenario: Ein Medienexport enthält identische Dateien unter verschiedenen Namen und unvollständige Metadaten.

1. Schritt 1: Hash- und Metadatenstrategie definieren.
2. Schritt 2: Assets prüfen, gruppieren und hochladen.
3. Schritt 3: Referenzen in Records aktualisieren.
4. Schritt 4: Vollständigkeit und Stichprobe auswerten.

Prüfkriterium: Dubletten werden erkannt; Zielassets besitzen eindeutige Metadaten und alle Records verweisen korrekt.

Cutover-Generalprobe

Szenario: Ein vollständiger Testlauf soll das geplante Produktionsfenster und alle Kontrollen simulieren.

1. Schritt 1: Aktuellen Export und Freeze-Annahmen vorbereiten.
2. Schritt 2: Gesamtlauf mit Zeitmessung durchführen.
3. Schritt 3: Abgleich und Frontend-Smoke-Test ausführen.
4. Schritt 4: Runbook und Entscheidungskriterien aktualisieren.

Prüfkriterium: Zeitbedarf, Restfehler, Deltaumfang, Smoke-Test und Rückfallpunkt sind belastbar ermittelt.

Prüf- und Abnahmekriterien

Die Übungen werden nicht allein nach sichtbarer Funktion, sondern nach Reproduzierbarkeit, Sicherheit, Datenqualität und Betriebsfähigkeit bewertet.

• Der Ausgangszustand, die Änderung und der geprüfte Zielzustand sind dokumentiert.
• Mindestens ein Negativ- oder Störungstest wurde kontrolliert durchgeführt.
• Geheimnisse, produktive Daten und unbeteiligte Systeme wurden nicht in die Übungen einbezogen.
• Offene Punkte besitzen Priorität, verantwortliche Stelle und nächsten Prüftermin.