When attempting to import a project after you have upgraded your TimeXtender software, you may encounter the following error:
Error: Cannot import project from the file <path> for the following reason: The project xml was generated in TimeXtender <version>. The project cannot be imported.
The repository upgrade process
The TimeXtender repository contains all of the metadata for all of your projects. When new features and fixes are introduced to TimeXtender, the structure of the repository will often change. The upgrade process will safely alter any projects to match the new shape of the repository database. However, this process happens only once, and only affects the projects already stored in the repository.
Export/repository mismatching
A project export contains the metadata for a specific project, and is essentially an XML snapshot of that project's current state in a project repository. To successfully import the project, it must be brought into a repository that is exactly the same version.
The solution
Cross-version importing
On unlocked project exports, it's possible to manually edit the file and update the <Version> property value under the <Projects> node. This may allow you to import into a slightly different TimeXtender version, but only if there are no structural differences between the export and the repository.
Upgrading your project export
In order to reliably import your project export into a newer version, you will need a copy of TimeXtender of the same version as your export, as well as a current version of TimeXtender. You can then use the following steps to upgrade the project export:
- Open the old version of TimeXtender
- Create a new repository
- Import the project
- Close the old version of TimeXtender and open the new version
- Under general settings, select the repository you just created
- You will be prompted to upgrade the repository - do so
- Open the project you previously imported
- Export the project - it has now been upgraded
- In general settings, select your primary project repository
- Import the new project export into your primary repository
Project downgrading
Note that the upgrade process cannot be run in reverse. This means that if altering the export's XML does not work, it will not be possible to import a project into an older version of TimeXtender.
