Migration to Uniface 10

Uniface 10 introduces significant conceptual and physical changes in the Uniface development environment and Repository. It is not possible to run the Uniface 10.3 IDE (or later) against an older Repository, such as Uniface 10.2 or Uniface 9. You must therefore migrate your existing sources to the new Repository.

For more information, see What's New in Uniface 10 Compared to Uniface 9.

When you install Uniface 10, it creates a new Repository into which you can import and automatically migrate your sources. If you want to use another supported database as your Repository, you can use Uniface to generate scripts for creating tables in the appropriate DBMS.

Caution: Do not run Uniface 10.3 against an earlier Repository, and do not use earlier meta model definitions in Uniface 10.3.

Uniface provides an automatic migration path when importing XML export files from supported Uniface versions. This is only possible when the XML file or files meet the following criteria:

  • They were created in Uniface 9.6, 9.7, 10.1, or 10.2.
  • They were created using formal Uniface export facilities—the Uniface export form in the Uniface Development Environment (Utilities > Export), or $ude("export")
Note:  Uniface 10 refuses to import XML files that are produced in earlier versions, or using Uniface 9 data copying facilities (Tools > Convert Data), /cpy on the command line, or $ude ("copy").

When importing and migrating XML files, Uniface does the following:

  • Checks the Repository version from which the XML file was exported.
  • Imports the XML file, if the import file was generated by an export command from a valid Repository.
  • Migrates the imported data to the new Repository structure.
  • Writes summary information about both import and migration actions to the log file, including any possible import and migration errors encountered.

The following topics describe the Migration Utility and the actions it performs, how to prepare and migrate to Uniface 10, the issues you may encounter during migration, and the steps to take to solve these issues.