FAQ & Troubleshooting the App

FAQ

Why a version is not shown on board?

There are several reasons why a version is not shown on a board:

  • A user does not have"Browse project" permissions. In this case, no versions of this project will be shown on the board.

  • The version has been archived. In this version of the Release Management app, it is not possible to see archived versions. This feature will be added in future versions.

  • The project has been deleted from the board configuration. In cases where the project has been removed from the "Projects in the board" section, all versions will correspondingly disappear.

Why can't I delete a column or change its status?

Usually, it is not possible to delete a column for two reasons:

  • The column contains versions. A column with versions inside cannot be deleted. Also, the status of such a column cannot be changed. In order to delete such a column - or change its status - please move the versions to other columns and perform the operation again. Also, it is valid if hidden versions are inside the column. In this case the icon will be shown next to versions count in the table.

  • The column is Default. It is not possible to delete or change the status of default columns.

How can I create multiple versions in several projects by a single click?

Bulk version creation to be done using the Create release function. In order to do so:

  • Navigate to the "Releases" tab.

  • Click "Create release" button.

  • Select projects where you want to create versions in

  • In corresponding projects, type the new version names you want to create.

  • You can create as many versions as you like for each project.

  • Click "Create release" button. A confirmation dialog will pop up. After clicking the confirmation button all the versions will be created in the corresponding projects.

Start and Release dates of the new version should be taken from the release properties.

How can I update status of multiple versions by a single click?

Release Management app has embedded functionality for massive version status changes within the scope of a release. Please read details in Bulk status update of versions in release chapter.

How can I archive or unarchive multiple versions in bulk?

The user can archive or unarchive multiple versions in a release. This function will be activated automatically during archive or unarchive a release. Please read more details in Bulk version archive or unarchive operations chapter.

How can I update multiple versions start and release dates in bulk?

The user is able to update start and release dates of versions in release in bulk or inherit dates from the release to the versions. This functionality is available:

How the projected release date is calculated?

Glossary

  • SD - start date

  • RD - release date

  • PRD - projected release date

  • PAD - projected amount of days in version/release

  • NDSS - Number of days since version/release started.

  • DPV - Done % of work in version

  • DPR - Done % of work in release

Formulas

  • PRD = SD + PAD;

  • PAD = (NDSS*100)/DP;

  • NDSS = today-SD (in days)

  • DPV = (done_issues_in_version+in_progress_issues_in_version/2)/all_statutes_issues_in_version*100

  • DPR = (done_issues_in_all_versions+in_progress_issues_in_all_versions/2)/all_statutes_issues_in_all_versions*100 

Version PRD

Version PRD is calculated when all conditions below are met:

  • SD is not empty

  • SD is in the past

  • % of done work >=30%

  • version is unarchived

  • version is unreleased

Version delay status

The version is considered as delayed in two cases:

  1. RD is not empty and RD is the past

  2. RD is not empty and PRD is calculated and PRD > RD

Version delay duration

Version delay duration in days is shown if the version is delayed (see above) and RD is not empty.

if(RD<today){

    return (PRD!=null&&PRD>today)?(PRD-RD):(today-RD);

}else{

    return (PRD>RD)?(PRD-RD):0;

}

Release PRD

Release PRD is calculated in cases:

  • All versions in the release have PRD or RD (Each particular Version will have PRD or RD)

  • Release PRD=latest RD or PRD of all versions in the release

Release delay status

The release is considered as delayed in two cases:

  1. Release RD is not empty and Release RD is the past

  2. Release  RD is not empty and Release PRD is calculated and Release  PRD > Release RD

Release delay duration

Release delay duration in days is shown if the release is delayed (see above) and Release RD is not empty.

if(Release_RD<today){

    return (Release_PRD!=null&&Release_PRD>today)?(Release_PRD-Release_RD):(today-Release_RD);

}else{

    return (Release_PRD>Release_RD)?(Release_PRD-Release_RD):0;

}

How to properly upgrade version of the App?

Server and Datacenter versions on Release Management App is a downloadable versions running on client hosting environment and connected to local database. Therefore it’s important to follow a prescriptive procedure for upgrading versions, namely

It’s a recommended approach to upgrade versions of the App 1-by-1 and do not jump between versions. This is the only proper way to insure integrity of your local database so all the alter- and migration- sprints will be applied properly.

In case you jump to higher versions by skipping some in the middle there’s a chance that some of the Release Board data won’t be consistent and board could not load properly.

You can always check the latest list of available versions at Atlassian Marketplace

https://marketplace.atlassian.com/apps/1218705/release-management-workflows-calendar-roadmaps/version-history

and plan your upgrade/downgrade strategy accordingly.

Troubleshooting the App

How to sent us extended Debug information

Sometimes the problem is not obvious and we need an extended Debug information to troubleshoot. Therefore, please follow the below guide to collect and send us such details so our team resolve your particular issue faster.

Right mouse click at some free space off the App and choose Inspect menu item. This will open your bowser development console.

Go to Network and apply filter by Fetch/XHR

Perform the action that is causing your errors/problems

As soon as the error will be shown, could you please check if any red lines will be in the following table?

If Yes, for each read line could you please send the following information to our team

Content from Headers tab. Just Copy & Paste it in support ticket.

Content from Response tab. Just Copy & Paste it in support ticket.

Appreciate it.