Migration Assistant

The Migration Assistant is a CLI tool that assists you with the migration of DaVinci Configurator Classic Version 5 Automation Interface scripts for execution with DaVinci Configurator Classic Version 6. It provides support for different migration use cases:

Depending on the migration use case, the Migration Assistant generates different output formats automatically:

Migration of script projects

Migration of script files

Migration of script file imports

Input format

Version 5 script project

Version 5 .dvgroovy script file

.groovy script files

Output format

Version 6 script project

Version 6 script project

.groovy script files

Features

Depending on the migration use case, the Migration Assistant covers different features:

  • Resolution of Version 6 imports: Resolving imports of Automation Interface APIs which were moved to a new Version 6 package

  • Setup of Version 6 build support: Providing a Gradle project structure to build a Version 6 compatible JAR artifact

  • Setup of scripting support: Enabling code completing, debugging and testing support

Migration of script projects

Migration of script files

Migration of script file imports

Resolution of Version 6 imports

x

x

x

Setup of Version 6 build support

x

x

Setup of scripting support

x

x

Limits

The Migration Assistant does not fully migrate the provided input as certain dependencies and changes cannot be covered automatically:

  • Script code: Script code that is affected by API changes is not migrated automatically.

  • External libraries: Dependencies to external libraries that are not compatible with the new setup are not migrated automatically.

Therefore, the generated output serves as a fundament for further manual migration.

Error Handling

The Migration Assistant does not support any kind of rollback migrated source code. Please use in case of an exception your source code management system to revert changes of the migration assistant.