Versions Compared

Key

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

...

When not to use it

It is tempting to create thousands of Jira issues with it. Don't. You will then have questions about keeping those issues up-to-date with Confluence, or across baselines. The goal is not to copy the entire Confluence database into Jira. In fact, we've limited to 100 Jira issues per batch for the moment, until we improve scaling.

  • It is much better to link a Jira issue to an entire page, rather than link an issue to every single requirement in it.

  • Creating 1 Jira issue for each requirement is a sign that you are managing the same data as requirements and as Jira issues.

  • It slows down the instance if you need to update a batch of Jira issues each time you update a Confluence page. We're happy to sell consulting services to diagnose and improve your performance, but it is a painful problem to have, and we've already optimized the product a lot. If you have the same data in Confluence and Jira, you should choose only one product.

The value of Requirement Yogi comes from annotating free text. If you keep transforming free text into Jira issues, you are making it painful for you to manage requirements. Perhaps don't create Jira issues in anticipation. Only create issues for tasks that you are going to perform during the next Sprint.

How it works

Explanation

Screenshot

Start from the Search screen, select a set of requirements and click on 'Create Jira issues'.

Note: The limit by default is 2000 requirements. It is defined by the global limit, available in the administration.

Image Removed
Image Added

Click on the blue plus button to create a new issue template.

Image Removed
Image Added

Template configuration:

  • Select a Jira instance.

  • Select a project.

  • Select an issue type.

  • Select a relationship.

  • Pre-configure fields.

If the checkbox 'Group all in one link' is checked, it will create one issue for all the selected requirements, otherwise, it will create one issue per requirement.

You can use some keywords to configure the issue's fields:

  • {key} will be replaced with the requirement's key.

  • {text} will be replaced with the requirement's text.

  • {baseline} will be replaced with the requirement's baseline number.

  • {relationship} will be replaced with the issue template's relationship.

  • {@any_property} will be replaced with the value of 'any_property'. Unlike the search syntax, you don't need to escape special characters here (property name is case-sensitive).

  • {ext@any_external_property} will be replaced with the value of 'any_external_property'. Unlike the search syntax, you don't need to escape special characters here (property name is case-sensitive).

Note that these reserved keywords will be ignored if you create one issue for multiple requirements.

Once an issue template is created, you can re-configure it. Note that only fields are editable. 

If you wish to change the project or the Jira instance, you will have to create a new issue template.

Image Removed
Image Added

Select requirements and Drag and drop into an issue template and click on create issues.

Image Removed


Image Added

Once issues are successfully created, they will appear on the right sidebar.

Image Removed
Image Added

Good to know

  • The templates limit is 30 per space.

  • You can't group more than 20 requirements in one Jira issue,

  • We truncate the summary to 253 characters because this is the Jira limit.

...