Migrating from Uniface 10.3 Community Edition

In Uniface 10.4, some fields in the Uniface Repository have been added and others enlarged. The Uniface 10.4 IDE cannot work with a 10.3 Repository, so to use your existing application definitions, you need to migrate them to the Uniface 10.4 Repository.

Before you begin:

  • Install the Uniface 10.4 Community Edition. It is installed in a different location (by default, under C:\Program Files) than the previous version, so your 10.3 installation continues to be available.

    Note: Do not uninstall the old Uniface installation until you have completed migration.

  • Review the changes made in Uniface 10. For more information, see What's New in Uniface 10.4.01 and Uniface 10.4.01: Repository Changes.

To migrate your existing application definitions:

  1. Start the Uniface IDE in your previous installation.
  2. Export definitions to XML files. You can choose to export all objects in the Repository, or make a selection of the objects you want to export.
    1. Choose Main Menu ( ≡ )> Export to display the Export Repository Objects form.
    2. To export all objects, click Select All Objects and enter the name of the XML export file, then click Export.

      Export form with Uniface * profile character in all fields

      Note: This will export all objects, including palettes and templates.

      Alternatively, you can specify only the objects you want to migrate using Gold * to select all objects of a specific type. (To enter Gold * (*), press the + key in the numeric keyboard, followed by *).

      Note: Although it is possible to export projects and their contents, this is not recommended because they do not include modeled properties, messages, or any other objects created with the editors available under More Editors.

  3. Start the Uniface IDE for 10.4, typically located in the Rocket Uniface 10 Community Edition folder of the Windows Start menu.
  4. Choose Main Menu ( ≡ )> Import XML... to open the Import Repository Objects form.
  5. Enter or browse for the file you just exported and click Import.This imports the repository objects and migrates them to the new Repository structure.
  6. Compile the imported objects.

    For example, to compile all objects and generate CMI files, start the Uniface IDE again and enter /all /cmi=1 in the command line dialog. For more information, see /all and /cmi .

  7. If you created external files such as JavaScript or CSS files, copy them from the old locations to the new ones.
  8. Test your application components to ensure everything is working.
  9. If you exported everything including templates and palettes, you can choose to reload the Uniface 10.4 templates which were overwritten by the import. Choose Main Menu ( ≡ ) > Load Templates and choose Load default templates.

Note: If you are not using the default installation paths, you may need to rename or delete your SQLite source database file for your previous installation to avoid any conflicts. This can typically be found in project\dbms\usys.db.