Zum Inhalt springen
ERP Preflight

Migration Template Intelligence

Validates SAP Migration Cockpit load files (migration templates, XML or CSV) against the schema the template declares: mandatory fields, field lengths and types, duplicate keys, hierarchy parents and cross-sheet references — with the record keys the load will report

Inhalt geprüft am 26. September 2026

Engine
MIGRATION_TEMPLATE_INTELLIGENCE
Domäne
Migration & Clean Core
Version
1.0.0
Ziel-Releases
S4H_2022, S4H_2023, S4HANA_CLOUD_2402, S4HANA_CLOUD_2408
Akzeptierte Formate
XML, CSV, TEXT

Eingabevertrag

SAP data migration template (Migration Cockpit 'Migrate Your Data' load file): the Excel 2003 XML spreadsheet as downloaded from SAP (all sheets, document properties OBJECT_NAME / VERSION / LANGUAGE, field list) or the CSV of one data sheet including its header rows (as converted from an XLSX by the upload): title row, SAP structure names, SAP field names, the type-specification row ('ETE;80;0;C;80;0'), group names ('Schlüssel' / 'Key') and field descriptions ('*' = mandatory), then the data rows. EN and DE templates.

Erforderliche Eingabe

  • A migration template data sheet with its type-specification row (XML spreadsheet or CSV)
  • Configuration options: existing_keys (record keys that already exist in the target system, e.g. parents loaded in an earlier delta; excluded from missing-parent / missing-reference findings), max_rows (default 1048576).
  • Values are compared after trimming leading / trailing blanks. Dates: YYYYMMDD, YYYY-MM-DD[THH:MM:SS], DD.MM.YYYY, MM/DD/YYYY or DD/MM/YYYY, 00000000. Numbers: optional sign, digits, one decimal separator, thousands grouping; the declared length includes the decimals.

Befundcodes

Befundcodes (8)

  • MIG_TEMPLATE_DUPLICATE_KEYStandard-Schweregrad: BlockerKategorie: DATA_INTEGRITY

    Doppelter Satzschlüssel

    Behebung: Behalten Sie genau eine Zeile je Schlüssel (alle Felder der Gruppe „Schlüssel“ zusammen); führen Sie die Duplikate zusammen oder löschen Sie sie. Die Migration verarbeitet einen Quellsatz je Schlüssel, Duplikate werden abgelehnt oder überschreiben sich gegenseitig.

  • MIG_TEMPLATE_HIERARCHY_CYCLEStandard-Schweregrad: BlockerKategorie: OBJECT_HIERARCHY

    Hierarchieverweise bilden einen Zyklus

    Behebung: Korrigieren Sie die Hierarchieverweise so, dass kein Satz (mittelbar) sein eigener übergeordneter Satz ist; eine zyklische Hierarchie kann die Migration nicht aufbauen.

  • MIG_TEMPLATE_HIERARCHY_PARENT_MISSINGStandard-Schweregrad: BlockerKategorie: OBJECT_HIERARCHY

    Übergeordneter Satz der Hierarchie ist nicht Teil der Ladung

    Behebung: Nehmen Sie die fehlenden übergeordneten Sätze in die Vorlage auf (vor ihren untergeordneten Sätzen) oder prüfen Sie, ob sie bereits im Zielsystem existieren, und geben Sie sie dann als vorhandene Schlüssel an. Untergeordnete Sätze eines fehlenden übergeordneten Satzes – und deren Nachfolger – lassen sich nicht in die Hierarchie einordnen und scheitern beim Laden.

  • MIG_TEMPLATE_CROSS_SHEET_REFERENCE_MISSINGStandard-Schweregrad: KritischKategorie: DATA_INTEGRITY

    Referenzierter Satz fehlt auf dem übergeordneten Blatt

    Behebung: Nehmen Sie die referenzierten Sätze in das übergeordnete Blatt der Vorlage auf (oder prüfen Sie, ob sie bereits im Zielsystem existieren); Zeilen, die auf einen fehlenden übergeordneten Satz verweisen, können nicht angelegt werden.

  • MIG_TEMPLATE_MANDATORY_FIELD_EMPTYStandard-Schweregrad: KritischKategorie: DATA_COMPLETENESS

    Pflichtfeld der Migrationsvorlage ist leer

    Behebung: Füllen Sie das Feld in jeder aufgeführten Zeile (die Vorlage kennzeichnet es mit „*“ in der Feldbeschreibung oder mit „obligatorisch für Blatt“ in der Feldliste) oder entfernen Sie Zeilen, die nicht migriert werden sollen. Sätze mit leerem Pflichtfeld werden bei der Migration abgelehnt; ein leeres Schlüsselfeld bedeutet, dass der Satz überhaupt nicht angelegt werden kann.

  • MIG_TEMPLATE_TYPE_MISMATCHStandard-Schweregrad: KritischKategorie: DATA_FORMAT

    Wert passt nicht zum in der Vorlage deklarierten Feldtyp

    Behebung: Korrigieren Sie die Werte auf den deklarierten Typ: Datum als JJJJMMTT, JJJJ-MM-TT oder im länderspezifischen Format (31.12.2026 / 12/31/2026), Uhrzeit als HH:MM:SS, NUMC-Felder nur mit Ziffern, Zahlen mit höchstens den deklarierten Nachkommastellen. Ändern Sie die Zellformatierung der Vorlage nicht.

  • MIG_TEMPLATE_VALUE_TOO_LONGStandard-Schweregrad: KritischKategorie: DATA_FORMAT

    Wert überschreitet die in der Vorlage deklarierte Feldlänge

    Behebung: Kürzen Sie die Werte auf die Länge aus der Typangabe der Vorlage (bei Zahlen: Vorkommastellen plus Nachkommastellen) oder bilden Sie sie vor dem Laden auf die Ziellänge ab; zu lange Werte werden bei der Übertragung abgelehnt.

  • MIG_TEMPLATE_SCHEMA_SUMMARYStandard-Schweregrad: InfoKategorie: SCHEMA

    Von der Migrationsvorlage deklariertes Schema

    Behebung: Keine Aktion erforderlich: Dies ist das Schema (Blätter, Felder, Typen, Pflicht- und Schlüsselfelder), das die Vorlage deklariert und gegen das die Daten geprüft wurden. Prüfen Sie, ob Migrationsobjekt und Version zum Migrationsprojekt des Zielsystems passen.

Codes der Eingabeprüfung (5)

  • MIG_TEMPLATE_ARCHIVE_REJECTEDStandard-Schweregrad: HochKategorie: INPUT_VALIDATION

    Archiv durch Sicherheitsgrenzen der Datenaufnahme abgewiesen

    Behebung: Das Archiv hat das Expansionsverhältnis von 100:1, die Gesamtgröße von 500 MB, die Eintragsanzahl oder die Verschachtelungstiefe von 2 Ebenen überschritten oder enthielt Pfadtraversierung bzw. verschlüsselte Einträge. Laden Sie ein flaches, unverschlüsseltes Archiv der Exportdateien hoch. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Migration Template Intelligence akzeptierten Formate (XML, CSV, TEXT) und starten Sie die Analyse erneut.

  • MIG_TEMPLATE_INVALID_INPUTStandard-Schweregrad: HochKategorie: INPUT_VALIDATION

    Artefakt entspricht nicht dem Eingabevertrag der Engine

    Behebung: Liefern Sie den für diese Engine dokumentierten Artefakttyp; fremde oder strukturell ungültige Dokumente werden abgewiesen. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Migration Template Intelligence akzeptierten Formate (XML, CSV, TEXT) und starten Sie die Analyse erneut.

  • MIG_TEMPLATE_PARSE_ERRORStandard-Schweregrad: HochKategorie: INPUT_VALIDATION

    Artefakt konnte nicht geparst werden

    Behebung: Beheben Sie den Syntaxfehler an der gemeldeten Zeile/Spalte (oder exportieren Sie die Datei unverändert erneut aus SAP). Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Migration Template Intelligence akzeptierten Formate (XML, CSV, TEXT) und starten Sie die Analyse erneut.

  • MIG_TEMPLATE_PAYLOAD_TOO_LARGEStandard-Schweregrad: HochKategorie: INPUT_VALIDATION

    Artefakt überschreitet die Größenbegrenzung

    Behebung: Teilen Sie den Export auf (z. B. nach Paket, Buchungskreis oder Zeitraum), sodass jeder Upload unter der Nutzlastgrenze des Dienstes bleibt. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Migration Template Intelligence akzeptierten Formate (XML, CSV, TEXT) und starten Sie die Analyse erneut.

  • MIG_TEMPLATE_INSUFFICIENT_INPUTStandard-Schweregrad: InfoKategorie: INPUT_VALIDATION

    Erforderliche Eingabe fehlt

    Behebung: Liefern Sie alle Eingaben, die der Engine-Vertrag als erforderlich kennzeichnet (siehe Eintrag im Engine-Katalog). Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Migration Template Intelligence akzeptierten Formate (XML, CSV, TEXT) und starten Sie die Analyse erneut.

Zurück zur Dokumentation
Migration Template Intelligence — ERP Preflight Docs