Versions Compared

Key

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

In the example below we have the following set-up in Jirawill create a project link with a project that has existing versions that we would like to keep:

Project: VCS - Source (

SOUR

team managed)

Versions: 1.0.0 & 2.0.0

Image RemovedImage Added

Project: VCS - Target

Project

1 (

TP1

team managed)

Versions: 1.0.0 & 3.0.0

Image RemovedImage Added

To share versions/components from the Source (SOUR) projectVCS - Source project, we will create a project link with project VCS - Target Project 1(TP1)

  • Navigate to the Administration interface of the Source project.Go to the Version & Component Sync page in the Source project.

  • Click on Get Started

Image Removed

Image Removed
  • Create a project link

Image Added
Image Added
  • 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 Source, click

  • Click on Next: Synchronisationsynchronisation

Image Removed

Image Removed

  • In this example we will use the default SchedulingDefault scheduling

  • To ensure existing versions maintain in VCS - Target Project 1 we will uncheck the Delete trigger. All other triggers will remain checked.

Note

Keep in mind

that unchecking the

that unchecking the Delete trigger means that none of the

‘Delete’

Delete events will be synchronised.

The deletion of

This means that:

  1. Existing versions will not be removed from the Target project(s)

  2. The deletion of a version/component in the Source

project will
  1. project will no longer result

in the deletion of the version/component in the Target project.
  1. in the deletion of the corresponding versions/components in the Source project(s). 


    Unfortunately, there is currently no option which will preserve manually created versions/components in Target project(s) whilst also synchronising the delete events in the Source project to the corresponding versions/components in the Target 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 Target project(s).

  • Click on Next: filters

Image Added

Image Added

  • 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: Confirmationconfirmation

Image RemovedImage 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)

Image Added
  • 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

Image Removed

Image Removed

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

Image Added

Synchronisation

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

Version 1.0.0

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

  • The app links version 1.0.0 in VCS - Source to version 1.0.0 in VCS - Target Project 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 Project 1

Version 2.0.0

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

  • The app creates version 2.0.0 in VCS - Target Project 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 Project 1

  • The app makes sure that upon creation of the ‘new’ version 2.0.0 in VCS - Target Project 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 Master VCS - Source are synchronised to version 2.0.0 in VCS - Target Project 1

Version 3.0.0

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

  • Due to unchecking the delete trigger the app will not delete version 3.0.0 inVCS - Target Project 1

Project: VCS - Source (

SOUR

team managed)

Versions: 1.0.0 & 2.0.0

Project: VCS - Target

Project

1 (

TP1

team managed)

Versions: 1.0.0

& 2

, 2.0.0 & 3.0.0

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 can change the apps synchronisation method, log level or delete the project link all together

Image Added
Image Added