Was bei einer Datenmigration dokumentiert werden muss – und warum

Die Migration ist geschafft. Die Daten sind im neuen System. Alles läuft. Und dann fragt sechs Monate später ein Kunde, warum eine alte Rechnung nicht stimmt. Jetzt zählt nur eine Sache: die Datenmigration Dokumentation. Gibt es sie nicht, beginnt die Suche im Nebel.

Genau dieses Szenario erleben wir regelmäßig. Die Migration selbst wurde sorgfältig geplant. Aber was dabei entschieden, geändert und geprüft wurde, hat niemand festgehalten. Dieser Artikel zeigt, welche Unterlagen Sie brauchen und warum jede einzelne davon Geld wert ist.

Warum die Dokumentation der Datenmigration so oft fehlt

Der Grund ist einfach: Nach dem Go-Live will jeder nur noch abschließen. Das Projekt hat länger gedauert als geplant. Das Budget ist aufgebraucht. Die Dokumentation wirkt wie Bürokratie, die niemand liest.

Das stimmt sogar. Niemand liest sie. Bis etwas schiefgeht.

Dann wird aus der ungeliebten Pflichtübung das wichtigste Dokument im Haus. Wer es nicht hat, zahlt die Rechnung später. Mit Zinsen.

Was eine Migration grundsätzlich umfasst, erklärt unser Überblick Was ist eine Software-Migration?

Was passiert, wenn nichts dokumentiert wird

Ohne Dokumentation entstehen drei konkrete Probleme.

Fehler lassen sich nicht zurückverfolgen. Eine Zahl im neuen System wirkt falsch. Stammt der Fehler aus dem Altsystem? Aus der Übertragung? Aus einer bewussten Umrechnung? Ohne Aufzeichnungen weiß das niemand. Die Analyse dauert Tage statt Minuten.

Verantwortung lässt sich nicht klären. Bei Streit mit Dienstleistern oder bei einer Prüfung zählt nur, was schriftlich vorliegt. Wer nichts vorlegen kann, steht schlecht da. Das gilt auch gegenüber Wirtschaftsprüfern und Datenschutzbehörden.

Wissen geht verloren. Die Menschen, die die Migration durchgeführt haben, wechseln irgendwann das Projekt oder die Firma. Was nur in ihren Köpfen steckt, geht mit. Das gleiche Problem kennen viele Unternehmen von ihrer Legacy-Software ohne Dokumentation.

Diese vier Dinge müssen Sie festhalten

Gute Nachricht: Eine brauchbare Migrations-Dokumentation ist kein Buchprojekt. Vier Bestandteile reichen in den meisten Fällen aus.

Mapping-Tabellen: Welches Feld wohin wandert

Eine Mapping-Tabelle ist eine simple Übersicht. Sie zeigt, welches Datenfeld aus dem Altsystem in welches Feld des neuen Systems übertragen wurde. Inklusive Umwandlungen: Datumsformate, Währungen, zusammengelegte oder aufgeteilte Felder.

Diese Tabelle ist das Herzstück der Dokumentation. Taucht später eine Unstimmigkeit auf, sehen Sie sofort, welchen Weg der Wert genommen hat.

Abweichungen und bewusste Entscheidungen

Keine Migration läuft ohne Kompromisse. Datensätze ohne Pflichtfelder, Dubletten, Karteileichen, kaputte Zeichensätze. Für jeden dieser Fälle wurde eine Entscheidung getroffen: übernehmen, korrigieren, verwerfen.

Halten Sie jede dieser Entscheidungen fest. Ein Satz pro Fall genügt. Wichtig ist das Warum. "500 Kundendatensätze ohne E-Mail-Adresse übernommen, Feld leer gelassen" ist eine brauchbare Notiz.

Testprotokolle: Was geprüft wurde und was nicht

Nach der Übertragung wird geprüft: Stimmen die Datensatz-Zahlen? Stimmen Summen und Salden? Funktionieren Stichproben im Tagesgeschäft? Ein Testprotokoll hält fest, was geprüft wurde, mit welchem Ergebnis und von wem.

Genauso wichtig ist die Gegenliste: Was wurde bewusst nicht geprüft? Diese Lücken sind später die erste Anlaufstelle bei Fehlern.

Rollback-Logs: Der Weg zurück

Ein Rollback ist die geordnete Rückkehr zum Altsystem, falls die Migration scheitert. Dokumentieren Sie, bis wann ein Rollback möglich war, wo die Sicherungen liegen und wer sie freigeben kann.

Auch nach erfolgreicher Migration bleibt das relevant. Denn die Sicherung des Altbestands ist oft die einzige Quelle, um alte Werte nachzuschlagen.

Wie lange müssen die Unterlagen aufbewahrt werden?

Eine pauschale Frist gibt es nicht. Als Faustregel gilt: so lange wie die migrierten Daten selbst. Für Buchhaltungsdaten sind das in Deutschland bis zu zehn Jahre. Die Finanzverwaltung verlangt, dass digitale Unterlagen nachvollziehbar und unveränderbar bleiben. Das schließt den Weg der Daten bei einer Migration ein.

Auch die Datenschutz-Grundverordnung (DSGVO) spielt hinein. Sie verpflichtet Unternehmen nachzuweisen, wie personenbezogene Daten verarbeitet wurden. Eine Migration ist eine solche Verarbeitung. Die Dokumentation ist Ihr Nachweis.

Bewahren Sie die Unterlagen deshalb zusammen mit der Sicherung des Altbestands auf. Beides gehört inhaltlich zusammen und wird im Ernstfall gemeinsam gebraucht.

So dokumentieren Sie pragmatisch

Sie brauchen kein spezielles Werkzeug. Eine strukturierte Tabelle, ein geteiltes Verzeichnis und feste Zuständigkeiten reichen aus.

Drei Regeln machen den Unterschied. Erstens: Dokumentieren Sie während der Migration, nicht danach. Nachträglich rekonstruiert wird lückenhaft. Zweitens: Benennen Sie eine Person, die die Unterlagen einsammelt und ablegt. Drittens: Legen Sie die Dokumente dort ab, wo sie in fünf Jahren noch jemand findet.

Wer die Migration noch vor sich hat, plant die Dokumentation am besten von Anfang an ein. Unsere Checkliste für eine sichere Datenmigration hilft dabei. Bei Altsystemen mit unklarer Datenlage lohnt zusätzlich der Blick auf unseren Leitfaden zur Datenmigration aus Altsystemen.

Fazit: Die Dokumentation rettet Sie im Ernstfall

Eine Datenmigration ohne Dokumentation ist wie ein Umzug ohne Inventarliste. Solange nichts fehlt, merkt es niemand. Sobald etwas fehlt, fehlt auch der Nachweis.

Mapping-Tabellen, Abweichungslisten, Testprotokolle und Rollback-Logs kosten während des Projekts wenige Stunden. Im Ernstfall sparen sie Tage, Nerven und im Zweifel ein Bußgeld.

Sie planen eine Migration oder haben eine hinter sich, bei der nichts festgehalten wurde? Sprechen Sie uns an. Wir schauen uns Ihre Situation an und sagen Ihnen ehrlich, was fehlt und was nachgeholt werden sollte. Das Erstgespräch ist kostenlos.