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.