Create project link: Existing project (v3.0.0)

In the example below we will create a project link with a project that has existing versions:

To share versions/components from the VCS - Source project, we will create a project link with project VCS - Target 1

• Navigate to the Version & Component Sync page in the Source project.

• Click on Create a project link

• Select the project(s) you want to link to the Source project. Versions from VCS - Source will be propagated to selected project(s)

• After selecting the desired projects to link to VCS - Source, click on Next:Synchronisation

• In this example we will use the default Scheduling & Trigger settings

• Click on Next: Filters

• The app will now show an overview of the versions that will be synchronised from the source project to the target project

• By creating filters you can control which versions are in-or excluded from synchronisation

• In this example we will not use any filters

• 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 first navigate to the Version & Component Sync page in the target project or click on the Linked project link in the source project

• Click on the Settings tab

• To provide you with insights in how the app works, this is what happens during synchronisation:

  • Upon creating a project link between VCS - Source & VCS - Target 1 the app checks whether there are versions present in VCS - Target 1

Version 1.0.0

• The app recognises that version 1.0.0 in VCS - Source already exists in VCS - Target 1

• The app links version 1.0.0 in VCS - Source to version 1.0.0 in VCS - Target 1

• This links ensures that any and all version changes to version 1.0.0 in VCS - Source are synchronised to version 1.0.0 in VCS - Target 1

Version 2.0.0

• The app recognises that version 2.0.0 does not exist in VCS - Target 1

• The app creates version 2.0.0 in VCS - Target 1

  • Jira does not allow you to link a single version to multiple projects. Therefore the app needs to create ‘new’ versions in VCS - Target 1

• The app makes sure that upon creation of the ‘new’ version 2.0.0 in VCS - Target 1 it is linked to version 2.0.0. in VCS - Source

• This links ensures that any and all version changes to version 2.0.0 in VCS - Source are synchronised to version 2.0.0 in VCS - Target 1

Version 3.0.0

• The app recognises that version 3.0.0 in VCS - Target 1 does not exist in VCS - Source

• The app deletes version 3.0.0 in VCS - Target 1