Mit Konfigurationsdaten arbeiten

Konfigurationsszenarien: loadconfiguration vs. saveconfiguration

Die folgenden Szenarien zeigen, wie Konfigurationen zwischen Business Central (BC), der lokalen DataMigratePro-Installation und ZIP-Archiven verschoben werden. Alle Beispiele setzen voraus, dass Basis-Einstellungen (Tenant, Endpoint, Datenbanken) bereits hinterlegt sind.

1. Konfiguration von BC nach lokal (-t loadconfiguration)

• Befehl: DataMigratePro -t loadconfiguration
• Ergebnis: Lädt Konfigurationsdaten aus BC in die lokale Umgebung. Enthalten sind Migration, Mapping, optionale BC Table/Field sowie Value Mapping und Value Mapping Value; die Daten werden blockweise per Pagination übertragen.
• Typischer Einsatz: Ausgangsbasis synchronisieren, bevor Änderungen lokal erfolgen.

2. Lokale Konfiguration nach BC zurückspielen (-t saveconfiguration)

• Befehl: DataMigratePro -t saveconfiguration
• Ergebnis: Sendet die lokal gepflegten Konfigurationstabellen nach BC. Vor dem Upload werden die Zieltabellen in BC geleert und anschließend chunkweise neu gefüllt.
• Wichtig: Die Tabellen BC Field und BC Table werden dabei nicht zurückgespielt.

3. Konfiguration aus BC als ZIP exportieren (-t loadconfiguration -o ./path/to/zipfile.zip)

• Befehl: DataMigratePro -t loadconfiguration -o ./ausgabe/configuration.zip
• Ergebnis: Speichert die von BC geladene Konfiguration als ZIP-Archiv mit den einzelnen JSON-Dateien, anstatt sie direkt in die lokale Datenbank zu schreiben.

4. Konfiguration lokal aus ZIP einlesen (-t loadconfiguration -i ./path/to/zipfile.zip)

• Befehl: DataMigratePro -t loadconfiguration -i ./pfad/zur/configuration.zip
• Ergebnis: Importiert eine zuvor exportierte Konfigurations-ZIP lokal, ohne BC zu kontaktieren (z. B. für Offline-Reviews oder Tests).

5. Lokale Konfiguration als ZIP sichern (-t saveconfiguration -o ./path/to/zipfile.zip)

• Befehl: DataMigratePro -t saveconfiguration -o ./ausgabe/configuration.zip
• Ergebnis: Erstellt ein ZIP-Archiv aus der aktuellen lokalen Konfiguration, das später nach BC hochgeladen oder versioniert werden kann.

6. BC-Konfiguration aus ZIP laden (-t saveconfiguration -i ./path/to/zipfile.zip)

• Befehl: DataMigratePro -t saveconfiguration -i ./pfad/zur/configuration.zip
• Ergebnis: Verwendet eine ZIP-Datei als Quelle und sendet deren Inhalt nach BC. Geeignet, um geprüfte Konfigurationen paketweise zu verteilen.