Configuration scenarios: loadconfiguration vs. saveconfiguration
The following scenarios show how configurations are moved between Business Central (BC), the local DataMigratePro installation and ZIP archives. All examples assume that basic settings (tenant, endpoint, databases) are already stored.
1. configuration from BC to local (-t loadconfiguration)
- Command:
DataMigratePro -t loadconfiguration - Result: Loads configuration data from BC into the local environment. Includes migration, mapping, optional BC Table/Field as well as Value Mapping and Value Mapping Value; the data is transferred in blocks via pagination.
- Typical use: Synchronize the starting point before changes are made locally.
2. restore local configuration to BC (-t saveconfiguration)
- Command:
DataMigratePro -t saveconfiguration - Result: Sends the locally maintained configuration tables to BC. Before the upload, the target tables in BC are emptied and then refilled chunk by chunk.
- Important: The BC Field and BC Table tables are not restored.
3. export configuration from BC as ZIP (-t loadconfiguration -o ./path/to/zipfile.zip)
- Command:
DataMigratePro -t loadconfiguration -o ./ausgabe/configuration.zip - Result: Saves the configuration loaded by BC as a ZIP archive with the individual JSON files instead of writing them directly to the local database.
4. read configuration locally from ZIP (-t loadconfiguration -i ./path/to/zipfile.zip)
- Command:
DataMigratePro -t loadconfiguration -i ./pfad/zur/configuration.zip - Result: Imports a previously exported configuration ZIP locally without contacting BC (e.g. for offline reviews or tests).
5. save local configuration as ZIP (-t saveconfiguration -o ./path/to/zipfile.zip)
- Command:
DataMigratePro -t saveconfiguration -o ./ausgabe/configuration.zip - Result: Creates a ZIP archive from the current local configuration, which can later be uploaded to BC or versioned.
6. load BC configuration from ZIP (-t saveconfiguration -i ./path/to/zipfile.zip)
- Command:
DataMigratePro -t saveconfiguration -i ./pfad/zur/configuration.zip - Result: Uses a ZIP file as the source and sends its contents to BC. Suitable for distributing checked configurations in packages.