Apps documentation
Requirements and Test Management for Jira
Cloud Server/Data Center
Requirements and Test Management for Jira

Cloud

Server/Data Center

Documentation
FAQ
Release notes
Articles & Videos
Last updated Aug 4, 2021

First steps

This chapter provides information on what happens after enabling RTM app.

Jira settings

Warning
Along with the app installation, RTM links appear in Jira configuration. RTM links are a mandatory element of application, therefore removing them will affect on all RTM operations. For further information, click here.
Warning
To properly configure the RTM app you need to have the Create issues permission.
Info
The Requirements and Test Management app does not support team-managed projects (formerly nex-gen).

You can start RTM Onboarding from the following places:

  • Jira settings > Apps > RTM Configuration
  • Project settings > RTM Configuration

In both ways you will be able to set up RTM for Jira app in your project.

Steps

To get started:

  1. Choose project you want to use.
    Info
    The Requirements and Test Management app supports only company-managed Jira projects. Team-managed projects are grayed out as Not compatible projects on the list.
  2. Click Enable.
    Testing in Jira
    Choose project you want to use with Requirements and Test Management for Jira

Result

Selected project is ready to manage.

Project settings

Requirements and Test Management for Jira app provides an extra RTM configuration section that appears in project settings. Here you can configure RTM module in project.

Warning
  • Before you start, log in as a user with the Jira Administrators global permissions.
  • Onboarding guide is shown only for projects which are using for the first time.

Before you start using RTM app:

  • Add issue types to project (select RTM issue types or add your own)
  • Map issue types to objects
  • Choose project and issue type for defects
  • Add fields to the screen.

RTM Issue Types

Your project can be based on RTM Issue Types or you can set your own issue types for each module.

Here’s a quick guide on how to add issue types provided by Requirements and Test Management for Jira app.

Steps

  1. Navigate to Issue Types.
  2. Click Add manually.
    a. Use Add automatically button if you want to add all RTM Issue Types without further interference in project settings.
    Jira Testing tool
    Choose project you want to use with Requirements and Test Management for Jira
  3. Click Actions > Edit issue types.
    Choose project you want to use with Requirements and Test Management for Jira
    Choose project you want to use with Requirements and Test Management for Jira
  4. Add all RTM issue types:
    • Test Execution
    • Test Plan
    • Functional Requirement
    • Non-Functional Requirement
    • Test case
    • Defect
    • Business Requirement
    • UI Requirement
      Note
      You can also use your own issue types. Adding issue types provided by RTM app is optional.
    1. Click Save.
      Requirements Management Jira
      Choose project you want to use with Requirements and Test Management for Jira
    2. Return to Onboarding page and click Next.

Result

RTM Issue Types have been added. Now you can map issue types to objects.

Note

Fields in RTM app are predefined and you cannot configure them.

Issue Types mapping

Map issue types to objects. Your issue types must be added in the project settings. If you forgot to add it earlier, go to Issue Type settings.

Steps

To map issue types to objects:

  1. Configure the following:
  • Requirements: Define up to several issue types.
  • Test Case: Define one issue type.
  • Test Plan: Define one issue type.
  • Test Execution: Define one issue type.
  1. Click Next.
    Jira Agile Test Management
    Map issue types with Requirements and Test Management for Jira

Result

Issue types have been mapped to the project.

Defects

You can store all defects in current project or you can set couple different projects where you create and store defects.

Steps

To add defects:

  1. Go to Defects.

  2. Configure the following:

    • Project: Choose a project.
    • Defect/Bug: Define up to several issue types.
      Note
      • You can add other projects and defects by clicking Add next project. If user chooses other projects, not default RTM project, the defects tree will not be available.
      • If you want to remove them, click the trash icon.
  3. Click Next.

    Add defect to project with Requirements and Test Management for Jira
    Add defect to project with Requirements and Test Management for Jira

Result

Selected defect is added.

Fields configuration

Add missing fields to RTM screens

Some Jira fields are required for app to work properly. In this step the RTM app will inform you which of them should be added to screen configuration.

test management tools that integrate with jira
Add fields to RTM screens

If the system detects missing fields, then click Add automatically or add fields manually.

Info

Information about missing fields also appears on the Configuration page.

test management tool features
Add fields to RTM screens

You can raise a support request for field’s compatibility right from the Configuration page.

Incompatible fields

The RTM app supports most of the fields available in Jira. However, it may happen that your fields won’t be visible on screens used by app. In Incompatible fields section you’ll find fields, that are not supported on the Create, Edit and View issue screens yet.

You can let us know if you find them crucial in your work. Simply click Request for field compatibility and raise a support request. We will do our best to add them.

Using Jira as test management tool
Supported fields

Click Next and navigate to the last step.

Confirmation

Now you can start your adventure with Requirements and Test Management for Jira app.

Steps

To start RTM app:

  1. Switch Generate sample data for project toggle to on if you need it.
  2. Click Start Adventure!
    Now you can start your adventure with Requirements and Test Management for Jira app
    Now you can start your adventure with Requirements and Test Management for Jira app

Result

RTM app is ready to use.

Info

The RTM app provides the SAMPLE_RTM label. Thanks to this, users can easily clear their projects from unnecessary data. Filtering issues in project by using SAMPLE_RTM label will expose all issues generated in Onboarding.

Test Management

You can start using RTM app by navigating to the relevant Project.
Expand the left sidebar and select Test Management from the project navigation.

Now you can start your adventure with Requirements and Test Management for Jira app
Now you can start your adventure with Requirements and Test Management for Jira app

List of projects with enabled RTM

As soon as you enable the RTM app, your project will appear on the Projects list in Apps > Test Management.

Now you can start your adventure with Requirements and Test Management for Jira app
Now you can start your adventure with Requirements and Test Management for Jira app

Here, you can enable Requirements and Test Management for Jira in other projects. Simply click Enable app in project, and select one from the list.

Need help?

If you can’t find the answer you need in our documentation, raise a support request*.
*Include as much information as possible to help our support team resolve your issue faster.