Release notes 2.2.5 for Jira

This release note focuses on Requirement Yogi for Jira and the the new feature for links in Jira issues.

Why?

We had to achieve better performance for the Data Center certification. We used to store those links in RIL ("Remote Issue Links", the built-in Jira panel). In order to increase the plugin's performance, we are now storing links in ActiveObjects (tables AO_42D05A_*).

On the upside, you get:

• A custom field for requirements, optional. It is particularly useful in the following situations:

  • If you want to link to requirements in the Create Issue form, which you couldn't do before,

  • If you want to require a link to a requirement at any step, including the Create step,

  • If you want to preset the relationship so the user can't change it.

• A new panel,

• A JQL function, so now you can search for all issue linked to a requirement.

Do administrators have anything to do?

No, in theory. You can:

• Check that you can see/add/remove Requirement Yogi links properly in a Jira issue,

• Check the progress of the upgrade job (see below).

Notes:

• Have you provided credentials in Confluence for Requirement Yogi, as explained in the Release 2.2?

• If you have anything that relies on RY's "remote issue links", you will have to migrate it. For example, if you have a workflow validation checking for the presence of a "remote issue link", you will have to replace it. For example, you can set up the Requirement Yogi custom field for this project, and make this field mandatory at that step. If you have a JQL function that relied on "remote issue links", you will have to use our JQL function instead, etc.

Checking the upgrade job

If this is not enough:

• The job executes tasks which are in AO_42D05A_AOTASK.

• The job stops when there's a task with type="UPGRADE_RIL_SUMMARY" and value="FAILED" or "SUCCESS".

• The job uses OfBiz to query data. If it can't, for any reason, the you can create items yourself in the table:

  • For each issue to migrate, create 1 AO_42D05A_AOTASK, with type='UPGRADE_RIL', status=null and details=the jira issue id or key ("10001" or "JRA-1" are both valid).

  • Then go to the administration and click "Relaunch".

New features!

New panel

What if we don't like the new panel?

• Please notify us and explain us. We may find solutions to improve your situation, and more importantly, we want to know about it before we go further with this implementation.

• Disable the panel: Go to UPM (the plugin manager), in our plugin, in the list of modules, disable the modules "issue-view-panel" and "sprint-board-panel" in UPM.

• Set up the custom field instead (see below). The custom field will take a much smaller visual footprint.

New custom field (optional)

The custom fields needs some configuration. Make sure you click "Configure" and you configure the relationship.

Note that for custom fields the plugin will fail to get the requirements description if you are running an old version of RequirementYogi (Confluence), so make sure to upgrade RequirementYogi to the latest version.

New JQL function (deprecated)

We have now a JQL Function named requirementYogiLinks to search for issues that are linked to RY requirements.

This function is deprecated and disabled by default, because it has a lot of tricky limits in terms of pagination. Use customfield in requirementYogiKeys(...) instead. See JQL Syntax.

Usage: issue in requirementYogiLinks('applink_id', 'relationship', 'space_key', 'key#baseline_number')

Examples :

Any argument can be replaced with '*' if it's not relevant.