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.