Version Sync
Benefits and Behavior
With version sync you have the possibility to store every version in a single issues and sync them with the release sections of your Jira projects. The benefits are:
assign version issues to responsible person of version
have your own workflow for the version issue
manage additional information over screens and customfields
use normal version custom fields like "FixVersion"
store version issues of a Jira project in the same Jira project or in a collective version project
use agile boards to manage versions of products
You can add a synchronization for the project you want to sync and select, if you want to store the version issue in the same or in a collective Jira project.
If enabling a version synchronizer for a project, all releases of that project will be created initially as Jira issues. Afterward it is only possible to create, edit or delete version in the version issues. The synchronization updates the standard release list automatically, so that you can use this list for choosing fix version or for navigation.
Enable Version Synchronizing
Starting Position for syncing versions
You have a Jira project with planned or unreleased versions like the following - this is your source:
Prepare the following configurations in the project, where you want to store your version issues - this is your target project (maybe the same as your source)
Add a new issue type for Versions.
Add screen(s) for the Version issue type with the fields: Version Archive Status, Version Status, Projects for Version Sync, Synced Versions - these are preinstalled with the add-on.
Add workflow for Version issue type.
Add a version syncronization
Open JIRA ADMINISTRATION → Add ons → STAGIL Assets and CRM → Synchronization → Version Sync → Manage
Fill out the Common Configurations:
user account for the synchronization - you need to choose a user who has the create permission in the target project
issue type - the issue type for the newly created version issues
description field - the custom field where the description of releases are stored in the issue
start date field - the custom field where the start date of releases are stored in the issue
Release date field - the custom field where the release date of releases are stored in the issue
and click Save.
Next, choose a JIRA Project as your Source Project. From this project the releases are created as version issues. Choose a target project in the field to project. This is the place where the version issues from source project are stored. Click Add & Synchronize to add the synchronizations.
You can add as many synchronizer as you want.
Delete a version synchronization
If you delete a synchronization
there will be no changes in the releases of the source project
the associated version issues are not deleted
you can create, edit or delete versions again through the release list
changes in associated version issues have NO effect on the releases anymore
and add a new synchronizer with the same source and target project again, then new version issues are created
Working with versions
Add a new version of project
Create a version issue in the project where you would like to store your versions.
Fill out the summary of the issue with the name of your version.
In the custom field Projects for Version Sync choose the name of your Jira project the version belongs to. You can only choose projects with an enabled version synchronization.
Fill out more information in your screen, if needed.
Synchronizers automatically create new release entries in the standard Jira release list.
Edit information of a version
It is not possible to edit information in the standard release list. Please use the link below Actions to go to the associated version issue and edit the information via the custom fields of the issue.
Release a version
For setting the status of a version you can use the custom field Version status in the version issue. Choose released or not released. This information is automatically transferred to the standard release list.
Archive a version
For setting the status of a version you can use the custom field Version Archive status in the version issue. Choose archived or not archived. This information is automatically transferred to the standard release list.
Delete a version
You can delete a version, if you deleted the version issue. The version is automatically deleted in the release list.
© 2023, STAGIL