Existing project (v2.10.2)

Owned by Jonas Hallensleben
Last updated: Oct 17, 2024
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)
    In this example we will create a project link with Linked Project 1

  • Click on Next:Synchronisation

  • Choose the desired synchronisation method, you can choose between Simple or Advanced
    In this example we used the Simple synchronisation method

  • 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 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)

Edit project link

To edit or delete an existing project link:

  • 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

  • Â