Converting Axon.ivy Designer Projects

Axon.ivy Project View

An outdated project version is communicated with an error marker X on the project node in the Axon.ivy Project View:

Outdated project

Axon.ivy Preferences

The current version of a project is also displayed in the Axon.ivy Preferences. A message is shown, if the version is out of date (i.e. conversion is needed):

Project version in properties: outdated and up to date

Convert an outdated project

To convert an outdated project proceed as follows:

Step 1	If you are using SVN or some other kind of version control then first update your local working copy to the head version. Ensure that you own all required locks. Check-in all pending changes before starting the conversion, so that you have a clean version that you can return to, in case conversion fails.
Step 2	If your project is not under team control then create a backup of the project, before starting the conversion.
Step 3	Right-click the project in the project tree view and select Convert Project.  Note for versions older than 4.2 In Xpert.ivy versions older than 4.2 the project conversion was invoked from the Xpert.ivy properties page. Invoking conversion from the project's context menu (after 4.2) Invoking conversion from the Xpert.ivy Properties (before 4.2)
Step 4	A protocol of the applied changes will appear (which will be saved as {project directory}/logs/conversionX-Y.log). If the conversion was successful, then the project version will be updated and shown in green.
Step 5	If your project is under team control, then check-in the changes due to the conversion. We recommend to check-in the conversion log as well, for later reference.
Step 6	Proceed with potentially necessary steps as described in the migration notes.