Info |
---|
In the example below we will explain how to create a project link with a Linked project and keep pre-existing versions/components. In order to create this project link we will use the synchronisation mode Advanced. If you are not yet familiar with the different synchronisation methods, please read the following documentation first. |
In the example below we have the following set-up in Jira:
Project: Master (MAS)
Versions: 1.0.0 & 2.0.0
Linked Project 1 (LP1)
Versions: 4.0.0 & 3.0.0
To share versions/components from the Master (MAS) project, we will create a project link with project Linked Project 1 (LP1)
Navigate to the Administration interface of the Master project.
Go to the Version & Component Sync page
Click on Get Started
Make sure to thoroughly read the message in the pop-up modal before you click on continue
Select the project(s) you want to link to the Master project, Versions from Master will be propagated to selected project(s)
In this example we will create a project link with Linked Project 1Click on Next:Synchronisation
Choose the desired synchronisation mode, you can choose between Simple or Advanced
In this example we will use the Advanced synchronisation methodAfter choosing the Advanced synchronisation method, the app will provide you with the option to configure which events should trigger a synchronisation.
By unchecking the Delete trigger, the app will no longer remove versions from the Linked project that do not exist in the Master projects
Note |
---|
Note
|
Uncheck the Delete trigger and 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
Synchronisation
Upon creating a project link between Master & Linked Project 1 the app checks whether there are versions present in Linked Project 1
Version 1.0.0
The app recognises that version 1.0.0 in Master does not exist in Linked Project 1
The app creates versions 1.0.0 in Linked Project 1
Jira does not allow you to link a single version to multiple projects. Therefore the app needs to create ‘new’ versions in Linked Project 1
The app makes sure that upon creation of the ‘new’ version 1.0.0 in Linked Project 1 it is linked to version 1.0.0 in Master
This links ensures that any and all version changes to version 1.0.0 in the Master project are synchronised to version 1.0.0 in Linked Project 1
Version 2.0.0
The app recognises that version 2.0.0 in Master does not exist in Linked Project 1
The app creates versions 2.0.0 in Linked Project 1
Jira does not allow you to link a single version to multiple projects. Therefore the app needs to create ‘new’ versions in Linked Project 1
The app makes sure that upon creation of the ‘new’ version 2.0.0 in Linked Project 1 it is linked to version 2.0.0 in Master
This links ensures that any and all version changes to version 2.0.0 in the Master project are synchronised to version 2.0.0 in Linked Project 1
Version 3.0.0
The app recognises that version 3.0.0 in Linked Project 1 does not exist in Master
Due to the unchecking of the Delete trigger, the app won’t delete version 3.0.0 in Linked Project 1
Version 4.0.0
The app recognises that version 3.0.0 in Linked Project 1 does not exist in Master
Due to the unchecking of the Delete trigger, the app won’t delete version 3.0.0 in Linked Project 1
Master (MAS)
Linked Project 1 (LP1)
Edit project link
To edit or delete an existing project link, click navigate :
Navigate to the version & component sync page in the Source project
Click on the triple dot menu on the right hand side
Here you can change the apps synchronisation method or delete the project link all together