Skip to content

Funktionsumfang

Das CMI MigrationTool bietet zwei grundlegende Funktionalitäten: - Validierung der Migrationsdaten (inkl. Abgleich mit dem Zielsystem) - Konvertierung der Migrationsdaten in DirectImport-Dateien nach erfolgreicher Validierung

Eine Migration von einem Drittsystem kann wie folgt aussehen: Ablauf

Es stehen zwei Befehle zur Verfügung (werden als Parameter mitgegeben): - validate: Führt die Validierung der Migrationsdaten durch ohne Erstellung der Json-DirectImport-Daten - convert: Führt die Validierung durch und transformiert die Migrationsdaten in das DirectImport-Json-Format

Das CMI MigrationTool kann über die Commandline mit Angabe von "validate" oder "convert" ausgeführt werden: CMI MigrationTool via Commandline ausführen

Falls das CMI MigrationTool mit dem Befehl "validate" ausgeführt und der Validierungsvorgang ohne Fehler ausgeführt worden ist, muss das Migrationstool nochmals mit dem Befehlt "convert" ausgeführt werden. Es werden nun die Directimport-Json-Dateien erstellt.

Validierungsvorgang

Der Validierungsvorgang enthält folgende Teilschritte:

  1. Modellvalidierung: Die Migrationsdaten werden gegen das Modell geprüft, ob sie formell korrekt sind (korrekt geschriebene Typdefinitionen, Feldnamen, Prüfung, ob Feldinhalt zum Feldtyp passt).
  2. Prüfung innerhalb der Migrationsdaten auf
  3. Vollständigkeit: Sind alle referenzierten Objekte auch tatsächlich vorhanden?
  4. Duplikate: Prüfung aufgrund der Duplikats-Definitionen in der Konfiguration
  5. Schreiben der Datenprüfungen für das Zielsystem (DataChecks)
  6. Refnum-Werte: Sind Refnum-Werte gültig? Sind sie eindeutig?
  7. ObjMustExists: Existiert ein referenziertes Objekt, das nicht in den Migrationsdaten gefunden worden ist im Zielsystem (z.B.: Gekobereich)?
  8. ObjMustNotExist: Existiert ein Objekt bereits im Zielsystem, muss aber aus den Migrationdaten her neu angelegt werden?
  9. DuplicateCheck: Prüfung auf Duplikate im Zielsystem
  10. Verarbeitung der Resultate der Datenprüfungen (DataCheckResults)
  11. Falls das Zielsystem ein Duplikat aus den DataChecks erkennt, wird die Guid des Objekts in der Antwort zurückgegeben. Das CMI MigrationTool wird aufgrund dieser Guid die Referenzen in den MigrationsDaten auf dieses Objekt im Zielsystem ausrichten.
  12. Allfällige Fehler (z.B. ein assoziiertes Objekt wird auch im Zielsystem nicht gefunden oder ein Refnumwert entspricht nicht dem hinterlegten Schema) werden entsprechend ausgewiesen.