This documentation has moved. For the most recent documentation, check out https://docs.adaptavist.com. Please update your bookmarks and links.
As explained in PCP-396, versions 1.11-JX or later will refuse to import files exported by earlier versions of the plugin. The reason is preventing possible errors as the meaning of references to users within the XML files are different, due to the change introduced by PCP-396. XML files exported by older versions reference users internally by their key, but XML configuracion files exported by version 1.11-JX or later, reference users internally by their username.
If necessary, a XML file generated by earlier versions can be upgraded automatically to work with version 1.11-JX or later, just follow these steps:
UpgradeXMLConfigFilesToV_1-11.xslt
2. Process the older XML configuration file with this XSLT. The result will be an XML configuration file valid for version 1.11-JX or later. This can be done with any XSLT processor. For example, with open source SAXON-HE XSLT processor by Saxonica Limited, you would run this command line:
java -cp saxon9he.jar net.sf.saxon.Transform original-file.xml UpgradeXMLConfigFilesToV_1-11.xslt > upgraded-file.xml
The upgrade process does two things:
WARNING: Cannot find name for user with key XXXX. Its key will be left unchanged
This situation will happen if the original XML file was exported with the option to avoid the export of some or all users. In these cases, the upgrade process might leave some references to user keys that do not coincide with the corresponding user name, so it might be a safer alternative to repeat the export with the new version of the plugin, instead of upgrading the old XML file.