Creating a project link with a existing project

Owned by Jonas Hallensleben
Last updated: Jun 29, 2021
3 min read

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: 1.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)

  • After selecting the desired projects to link to Master, click on Next:Synchronisation

  • Choose the desired synchronisation mode, you can choose between Simple or Advanced

  • In this example the synchronisation mode is Simple

  • After choosing your desired synchronisation mode, 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 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 already exists in Linked Project 1

  • The app links version 1.0.0 in Master to version 1.0.0 in Linked Project 1

  • This links ensures that any and all version changes to version 1.0.0 in Master are synchronised to version 1.0.0 in Linked Project 1

Version 2.0.0

  • The app recognises that version 2.0.0 does not exist in Linked Project 1

  • The app creates version 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 Master 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

  • The app deletes version 3.0.0 in Linked Project 1

    • For a more detailed explanation on why the app removes version 3.0.0 from Linked Project 1 please read about the different synchronisation modes

 

Master (MAS)

Linked Project 1 (LP1)