Synchronisation Modes

As explained on the synchronisation modes page there are two synchronisation modes:

1. Simple

2. Advanced

The default sync mode when creating project links is Simple. When using this sync mode the app will:

1. Delete any versions/components in the Linked project that do not exist in the Master project

2. Propagate any and all changes made to versions/components in the Master project to the corresponding versions/components in the Linked projects

3. The create and edit features of the versions/components configuration screen, will be disabled

This means that if you create a project link using default settings the app won’t allow you to keep pre-existing versions/components in your Linked project. In addition it won’t allow you to create versions/components in Linked projects.

To keep pre-existing versions/components in a Linked project, you need create a project link using the Advanced sync mode.

Advanced Sync mode

Using the Advanced sync mode gives you more control over the synchronisation of versions/components in Linked projects. It allows you to:

1. Select the specific events you would like to synchronise to the corresponding versions/components in Linked projects

2. Create versions/components in Linked projects

So how this sync mode allows us to keep pre-existing versions in Linked projects?

Create project link

In the example below we have the following set-up in Jira:

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 Advanced

• 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

would like to synchronise to linked projects. If you would like to be able to keep manually created components in project A & B please uncheck 'Delete' in the 'Specific Changes' panel. 

The "Delete" event ensures that Version & Component Sync will remove all versions/components in 'Linked Projects' that are not present in the 'Master' project.

Keep in mind that unchecking the “Delete” event means that none of the “Delete” events will be synchronised. The deletion of a component in project A  will no longer result in the deletion of the component in projects B & C. Unfortunately, there is currently no option which will preserve the manually created versions/components whilst also deleting any version/component that does not exist in the Master project. This is a limitation which comes from the fact that the app has no means to determine if a version/component was manually created in the linked project.

Please let me know if you have any additional questions!

Kind regards,

Jonas Hallensleben