In the example below we have the following set-up in Jira:
Project: Source (SOUR)
Versions: 1.0.0 & 2.0.0
Target Project 1 (TP1)
Versions: 1.0.0 & 3.0.0
To share versions/components from the Source (SOUR) project, we will create a project link with project Target Project 1 (TP1)
Navigate to the Administration interface of the Source project.
Go to the Version & Component Sync page
Click on Get Started
Select the project(s) you want to link to the Source project. Versions from Source will be propagated to selected project(s)
After selecting the desired projects to link to Source, click on Next:Synchronisation
In this example we will use the default Scheduling
To ensure existing versions maintain in Target Project 1 we will uncheck the Delete trigger. All other triggers will remain checked.
Keep in mind that unchecking the Delete trigger means that none of the ‘Delete’ events will be synchronised. The deletion of a version/component in the Source project will no longer result in the deletion of the version/component in the Target project.
Unfortunately, there is currently no option which will preserve manually created versions/components in Target project(s) whilst also synchronising the delete events in project Source to the corresponding versions/components in the Linked project(s).
This limitation comes from the fact that the app has no means to determine if a version/component was manually created in the Source project(s).
Click on Next: Confirmation
The app will now show an overview of the project link(s) you are creating
Click on save, to save the project link(s)
Upon clicking on save, the app will:
Start synchronising
Shown an overview of the created project links and their current status
To edit or delete a existing project link click on the triple dot menu on the right of the project link
To provide you with insights in how the app works, this is what happens during synchronisation:
Upon creating a project link between Source & Target Project 1 the app checks whether there are versions present in Target Project 1
Version 1.0.0
The app recognises that version 1.0.0 in Source already exists in Target Project 1
The app links version 1.0.0 in Source to version 1.0.0 in Target Project 1
This links ensures that any and all version changes to version 1.0.0 in Source are synchronised to version 1.0.0 in Target Project 1
Version 2.0.0
The app recognises that version 2.0.0 does not exist in Target Project 1
The app creates version 2.0.0 in Target Project 1
Jira does not allow you to link a single version to multiple projects. Therefore the app needs to create ‘new’ versions in Target Project 1
The app makes sure that upon creation of the ‘new’ version 2.0.0 in Target Project 1 it is linked to version 2.0.0. in Source
This links ensures that any and all version changes to version 2.0.0 in Master are synchronised to version 2.0.0 in Target Project 1
Version 3.0.0
The app recognises that version 3.0.0 in Target Project 1 does not exist in Source
Due to unchecking the delete trigger the app will not delete version 3.0.0 in Target Project 1