Synchronisation Modes

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

Simple
Advanced

When using the Simple sync mode the app will:

Delete any versions/components in the Linked project that do not exist in the Master project
Propagate any and all changes made to versions/components in the Master project to the corresponding versions/components in the Linked projects
The create and edit features of the versions/components configuration screen, will be disabled

...

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

...

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:

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

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

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.

...

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

Image Added

Linked Project 1 (LP1)

Versions: 4.0.0 & 3.0.0

Image Added

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

Image Added

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

Image Added

Choose the desired synchronisation mode, you can choose between Simple or Advanced
In this example we will use the Advanced synchronisation method
After choosing the Advanced synchronisation method, the app will provide you with the option to configure which events should trigger a synchronisation.

Image Added

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
Keep in mind that unchecking the Delete trigger means that none of the Delete events will be synchronised. This means that:

Existing versions will not be removed from the Linked project(s)
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).

Uncheck the Delete trigger and click on Next:Confirmation

Image Added

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

Image Added