Maven is the easiest way to install the module. Add the following dependency to your bundle:
This module includes a content app called migration tool, which is registered in the Edit menu:
The app lists all definitions with UI5 elements registered in Magnolia:
Definitions can be filtered out by:
- Problem Severity
A single definition can be previewed before the migration (5UI)
And after the migration 6UI
The migration of all definitions can be done at once with the action "Migrate Dialogs"
All definitions will be saved as YAML files inside the light modules registered folder, in a subfolder called "migration". Inside this folder there will be a subfolder for each module that contains a migrated definition and the YAML will be inside:
The converted YAML files will include as comments the original definition and the decorations processed. Example converted definition:
What if my definition is decorated?
The migration tool converts definitions in the registry. The migration process will take into account all decorations applied to the original definition. The converted YAML will include as addional info the decorations processed by the registry.
What if my definition uses include files?
The files included will be converted into a unique YAML file, since, the migration tool converts definitions in the registry (which already applies all includes in one final definition). The migration tool does not override the original definition files(s), so you can easily recreate the previous structure of include files using the data from the converted YAML.
What if my definition uses inherits?
The converted YAML will not keep the inherit structure. The migration tool converts definitions in the registry. The migration process will take into account all inherits applied to your definition and produce a fully expanded YAML file, repeating the configs inherited. The migration tool does not override the original definition files(s), so you can easily recreate the previous structure of inherits using the data from the converted YAML.
What if I use blossom definitions?
Blossom definitions are not fully supported by the definitions app and the registry, which is used as a datasource in migration tool app. Since Blossom dialogs can't be detected, the migration tool app cant migrate them.
- This module is at INCUBATOR level.
- Version 1.0 - Initial release of the module.
- Version 1.0.1 - decorations processed included as part as the converted YAML file.