Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

Note
Version & Component Sync will apply changes to versions/components retroactively upon creating the project link.

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

Project: VCS - Source (team managed)

Versions: 1.0.0 & 2.0.0

VCS DC - Existing project (1).pngImage Modified

Project: VCS - Target 1 (team managed)

Versions: 1.0.0 & 3.0.0

VCS DC - Existing project (2).pngImage Modified

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

VCS DC - Existing project (3).png

VCS DC - Existing project (4).png

  • 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

VCS DC - Existing project (5).png
VCS DC - Existing project (6).png

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

  • Click on Next: Filters

VCS DC - Existing project (7).png
  • 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

    VCS DC - Existing project (8).png

  • 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

VCS DC - Existing project (9).png

VCS DC - Existing project (10).png
  • 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

VCS DC - Existing project (11).png
  • 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

Project: VCS - Source (team managed)

Versions: 1.0.0 & 2.0.0

VCS DC - Existing project (12).pngImage Modified

Project: VCS - Source (team managed)

Versions: 1.0.0 & 2.0.0

VCS DC - Existing project (13).pngImage Modified