After moving a page across spaces, the requirements links in Jira are broken

Description

Symptom

  • In 2.3.0, the "Requirements" panel in Jira displays a red error message.

  • In 2.3.1, the "Requirements" panel in Jira tells the user that they should fix their requirements and provides an administration screen.

What is the problem

In 2.3.0, we had a bug where we didn't manage the MOVED event properly.

  • If a page was moved across spaces,

  • It would send a notification to Jira, telling it to move the links of requirements,

  • This automation, by mistake, would set NULL to the keys of all moved requirements. It wouldn't affect Confluence, only Jira. The text of the requirement remains untouched.

How to check whether any requirement on your instance has this issue

As an administrator, go to the Jira administration -> Applications -> Requirement Yogi -> Resynchronize. If you are affected, a big red error message will be displayed.

Alternatively, check the page http://your-jira-instance/secure/admin/ry-recover-null-keys!default.jspa directly.

How to correct this problem

  • Install RY 2.3.1 or above;

  • Go to the administration screen. The link is provided in the issues ; or you can go to the Requirement Yogi administration, tab "Resynchronize", or the URL is http://your-jira-instance/secure/admin/ry-recover-null-keys!default.jspa .

  • Using this administration screen, we provide guesses as to which requirement should have which key. Those guesses are based on the requirement text.

  • Click Associate once you are sure which requirement matches.

Environment

None

Observations

None
Resolved

Assignee

Unassigned

Reporter

Adrien Ragot (Play SQL / Requirement Yogi)

Labels

None

Participants

None

Fix versions

Affects versions

Priority

Matter of months