New project (v3.0.0)

Owned by Jonas Hallensleben
Last updated: Oct 17, 2024
4 min read

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

Project: VCS - Source (team managed)

Versions: 1.0.0 & 2.0.0

VCS DC - Create project link (1).png

Project: VCS - Target 1 (team managed)

Versions:

VCS DC - Create project link (2).png

 

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)
    In this example we will create a project link with VCS - Target 1

  • 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

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 does not exist in VCS - Target 1

  • The app creates versions 1.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 1.0.0 in VCS - Target 1 it is linked to version 1.0.0 in VCS - Source

  • This links ensures that any and all version changes to version 1.0.0 in the VCS - Source project 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 versions 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 the VCS - Source project are synchronised to version 2.0.0 in VCS - Target 1

Project: VCS - Source (team managed)

Versions: 1.0.0 & 2.0.0

 

 

Project: VCS - Target 1 (team managed)

Versions: 1.0.0 & 2.0.0

 

 

Edit project link

To edit or delete a existing project link:

  • Navigate to the Version & Component Sync page in the target project or click on the Linked project link on the Version & Component Sync page in the source project

  • Navigate to the Settings tab

  • Here you change the apps synchronisation method, log lever or delete the project link all together