Versions Compared

Key

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

Overview

This section provides a brief introduction to the navigation and main views of R4JeaseRequirements.

Table of Contents

Navigation

Navigating to R4J in Jira Cloud

Go to easeRequirements via the Project Sidebar

Once a project is activated for R4J easeRequirements Cloud, an additional navigation item appears in the project sidebar that provides access to the R4J easeRequirements components:

  • 1: Requirements Management for Jira in On Software Projects: Select easeRequirements in the project sidebar

  • 2: R4J sidebar to navigate 1: On Business Projects: In the apps-dropdown of the project select easeRequirements

  • 2: Use the navigator bar to switch to the tree, coverage, and coverage baseline views

Image RemovedImage Added

Go to easeRequirements via the Apps Menu

After activating project(s) for R4JeaseRequirements, go to the top Apps menu in your Jira navigation and select easeRequirements.

image-20240826-145204.pngImage Added

Go to easeRequirements via shared URL

Selected items in the tree and coverage view are reflected in the browser address bar through parameters issueKey and viewId, respectively. When these parameters are not present, the project folder will be selected.

Copy/paste the URL from the address bar to share the direct access it with your colleagues. Jira project permissions apply, so ensure that your colleagues have sufficient permissions to view the project issue or view you’re sharing.

Back/Forth browser navigation

Item navigation in the apps components is supported by the browser history. This means going back and forth between the item you’ve selected using the browser’s back and select R4J.

Image Removed

forward buttons.

Clicking issue key links in the views that are in the Project Tree will select the item in the tree. Otherwise, you are redirected to the Jira issue view or the Jira issue dialog will open.

API Token generation

To use the easeRequirements REST API endpoints, you will need to create an app related API Token.

  • 1: Click on your user avatar on the top right of the Jira navigation

  • 2: Click on easeRequirements - API Token to go to create an API Token for yourself

Image Added

Project Tree and Sub-views

Organize requirements in a Project Tree. To access the Project Tree and its sub-views, select Tree from the R4J sidebarapp navigation.

The Detail Viewincludes all the information of the selected requirement: summary, description, other fields, statistics (for folder issue types), child requirements, issue links, attachments, comments, along with workflow actions. To open the detail view, select a specific issue from the Project Tree.

Image Removed

Image Added

  • 1: Click on the search button to perform a tree text search which highlights the matching issues of the text input in the tree

Image Added
  • 2: Click on the filter button to perform a filter of the tree which only shows the matching issues of the text input in the tree

Image Added

The Reading View allows for a better context of your requirements through flowing content.

Coverage
  • 1: Toggle this icon to switch between the detail view and reading view for folders

Image Removed
  • 2: Manage the display fields you want to show in the reading view

Image Added

The Tabular View allows for a quick review of your requirements through a table form content.

image-20240820-061433.pngImage Added

Coverage and Traceability View

The Coverage and Traceability View provides insight into the consequences of requirement changes. It also shows how complete the coverage is. For example, the view can show whether all features have corresponding requirements. To open the view, select Coverage/Traceability from the R4J sidebar app navigation and then select a specific view. See

Coverage View

Traceability View

to learn how views are created.Image Removed

image-20240820-060435.pngImage Added

image-20240820-060611.pngImage Added

Baseline

The Baseline allows you to view all the important milestones captured for the project. To open the view, select Baseline from the app navigation.

Image Added