This documentation has moved. For the most recent documentation, check out Please update your bookmarks and links.

Skip to end of metadata
Go to start of metadata

What is It?

Import Conflict Detection is a new feature available in Project Configurator v2.2.0 or higher. It is a report that shows, for a given import file, the objects in Jira that would be mapped during the import as counterparts of objects included in the new configuration. All mapped objects are shown, even if the new configuration does not imply changes to those objects. Usually when an object is mapped as the equivalent of another object coming with the import it is because both of them have the same name. In this sense, if this mapping produces undesired effects, it is usual to say that there is a "name conflict".

This is quite relevant for these reasons:

  • Those objects will get the new configuration as defined in the file to be imported, that means their previous configuration will be overwritten (with some exceptions). This might have an impact on other projects at the destination instance, apart from the projects being imported.
  • If the object coming in the imported file and its counterpart at the destination represent different things, even if they have the same name, the result of the migration will be confusing for users. What would the meaning of having an issue in status "Reopened" be after a migration, if at the destination instance "Reopened" meant "rejected by end user" and at the source instance for the imported projects it meant "it did not pass QA" ?

How Does it Work?

The Import Conflict Detection link is located in the same menu where you can export and import projects.

Clicking on that link opens a new page (see below), where the user can specify the import file to be analyzed for possible "name conflicts" with existing objects at the destination instance. It can work from "configuration only" XML files and "complete project" ZIP files.

In the conflict detection form, you have to select the type of project import file you want to analyse, using the drop-down list at the top. After selecting a file type, the rules for specifying the import file are the same as for importing:

  • select an XML configuration file to upload ("configuration only.")
  • write the name of a valid zip file located in the {JIRA_HOME}/import/projectconfigurator folder ("complete project.")

You can also choose to skip some object types. This has the same meaning as in the case of importing configurations or complete projects. Finally, click the "Import conflict detection" button to launch the report.

Conflict Detection Results Example

This displays first a page with a progress bar, to wait until the report is generated. Afterward, a new page appears with the contents of the conflict detection report. This report shows in its left side the list of objects that will be mapped as targets of objects included in the import file. The right column includes the option to show where those objects are being used. This follows the same rules and limitations as the Object Dependencies report.

When a conflicting object appears in that list of "using" objects, you can click on that link and the page scrolls to its position.