Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

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 modes, please read the following documentation first.

Create project link

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 1

  • After selecting Linked Project 1, click on Next:Synchronisation

  • On the next screen you can choose your desired synchronisation mode, Simple or Advanced

  • We will create a project link using the Advanced synchronisation mode

  • After choosing the Advanced synchronisation mode, the app will provide you with the option to configure which events should trigger a synchronisation.

  • By unchecking the Delete event, the app will no longer remove versions from the Linked project that do not exist in the Master projects

Note
Keep in mind that unchecking the Delete event means that none of the Delete events will be synchronised. This means that:

  1. Existing versions will not be removed from the Linked project(s)

  2. The deletion of a version/component in the Master project will no longer result in the deletion of the corresponding versions/components in Linked project(s). 

    Unfortunately, there is currently no option which will preserve manually created versions/components in Linked project(s) whilst also synchronising the delete events in project Master 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 Linked project(s).

  • Please uncheck the Delete event 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

  • 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 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 event, 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 event, the app won’t delete version 3.0.0 in Linked Project 1

Master (MAS)

Linked Project 1 (LP1)

  • No labels