Requirements

It is very common to use specialized requirements management tools to manage requirements like user stories, epics, or other artifacts. Test Manager^TM supports the synchronization of requirements from external tools as well as the creation of requirements from within Test Manager^TM. In a Test Manager^TM project, there can be requirements that are synced from external tools as well as requirements that were created in Test Manager^TM.

Navigation and Search

To quickly find your requirements, use the search function and the filters. Navigate within the page using and configuring the paginator. Alternatively, you can use the breadcrumb to navigate between the pages.

1. Filter - You have two filter tabs to choose from:

   • Browse - to list all requirements.
   • Updated by me - (predefined) to list only the requirements that have been updated by the current user, running the Test Manager^TM instance.

2. Search - Use the search bar to find requirements by their key, name or labels (requires full search term match).

   You can use the search bar at the top of the page to look for items across Test Manager^TM (e.g., test sets, test cases).

Creating Requirements

To create requirements in a Test Manager^TM project:

1. In the Test Design menu, navigate to the Requirements page.
   
   

   

   
   
2. Click Create Requirement. The Create Requirement window is displayed.
3. Fill in the fields accordingly:
   • Name - The name for your requirement.
   • Description - (Optional) Add any description to the requirement. In order to add formatted text, use Markdown syntax.
   • Optionally, add any number object labels.
4. Click Create. Your new requirement is displayed in the Requirements page.
   Tip: Upload documents

Synchronizing Requirements from External Tools

In order to keep requirements from external ALM tools in sync with requirements from Test Manager^TM, configure a connection first. Refer to About ALM Tool Connectors to learn how to configure a project to be synchronized with an external ALM tool.

Once a connection is configured properly, any requirement which is created in the external tool is also created in Test Manager^TM. The name and description of those requirements are also kept in sync when changed in the external tool. In Test Manager^TM, these attributes are read-only.

Note: After a connection to an external ALM system has been configured, no initial synchronization of existing artifacts is performed. This should avoid creating huge amounts of data in Test Manager^TM without any prediction on how long this would take. However, whenever an object in the external tool is updated, it will be created in Test Manager^TM in case it does not exist.

Cloning requirements

You can only clone one requirement at a time.

1. Select More Options for the requirement that you want to duplicate and then Clone.
   The Clone panel appears.
2. Select the information that you want to clone:
   1. Test case assignments
   2. Documents
   3. Labels

      Custom field definitions, and custom field values are also cloned if they exist.

3. Select Confirm to clone the requirement.
   The Requirement will be cloned in the background message appears.

   
   

   

   
   

A clone of the requirement is created, with a different Id.

Jira Requirements

Synchronizing Objects from Jira to Test Manager^TM

Test Manager comes with a Jira connector pre-installed. On your Jira instance, the UiPath® Test Manager^TM for Jira apps needs to be installed from the Atlassian marketplace. See Connecting a Jira Project to learn how to configure Jira and Test Manager^TM to enable synchronization.

Objects are synchronized from Jira to Test Manager^TM under the following circumstances:

• An object is created in Jira and Jira is configured to synchronize this type of object.

• An object is updated in Jira and Jira is configured to synchronize this type of object.

  Note:

  If an object is updated in Jira which does not exist in Test Manager^TM, a new requirement will be created in Test Manager^TM.

  If an object is deleted in Jira, the synchronized object in the Test Manager^TM will remain. Test Manager^TM never propagates deletions across systems.

Enforcing Synchronization

For a particular object, synchronization can be enforced immediately. This can be helpful under the following circumstances:

• Objects are out-of-sync for any reason - for example, Test Manager^TM was not available while the Jira object was updated.
• A new Jira connection has been set up in Test Manager^TM and objects which already existed in Jira need to be synced.

To enforce synchronization of an object:

1. Open the object in Jira.

2. Click Push to Test Manager^TM from the More menu. Synchronization is invoked immediately.

   Note: Please note that Test Manager^TM does not perform a sync-all operation after a Jira connection has been set up.