Quickstart guide

This quickstart guide provides you with a comprehensive introduction to Test Manager, empowering you to efficiently manage and execute test cases for your Studio projects. Test Manager offers a robust test management solution with support for multiple test frameworks, integration with various source control systems, and advanced reporting capabilities.

Follow these steps to get started with Test Manager:

Creating requirements

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

In the Test Design menu, navigate to the Requirements page.
Click Create Requirement. The Create Requirement window is displayed.
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.
Click Create. Your new requirement is displayed in the Requirements page.

Tip: Upload documents

Cloning requirements

To expand your testing portfolio, you can clone one requirement at a time. To clone a requirement:

Select More Options for the requirement that you want to duplicate, then Clone.
Choose the information that you want to clone, and then select Confirm.

Creating test cases

Test Manager provides a set of features for creating, managing, and executing test cases for your projects. This guide walks you through the process of creating test cases, assigning automations to them, adding manual steps, and linking requirements.

Creating test cases

Build your testing portfolio, and create test cases within Test Manager:

Open your project in Test Manager and navigate to the Test Cases section.
Select Create Test Case and configure the test case details such as name, version, description, and labels.
Select Confirm, and the test case will be displayed under Test Cases.

Linking test cases to requirements

To establish traceability between test cases and requirements, you can assign test cases to requirements in Test Manager.

Open the desired test case.
Go to Tasks, and select Assign to Requirement.
Choose the requirements you want to link the test case to.
Select Assign to save the changes.

Assigning Studio automation to test cases

Test cases in Test Manager can include both manual steps and a Studio automation. The automations are created in Studio as test cases, using the available activities. You need to assign Studio automations to test cases from Test Manager, to use automated executions.

To link an automation created in Studio to a test case in Test Manager:

Integrate Studio with Test Manger, and configure the Test Manager Settings from the Studio Design ribbon.
Select Link to Test Manager.
Configure the test case information, such as:
- Project: Select your project. If you did not set a default project for Test Manager, see Integrating with Studio.
- Test: Select a test case from the dropdown list.
- Name: Enter a name only if you create a new test case in Test Manager.
- Requirement: Leave this field blank if you don't want to link the test case to an existing requirement. The name is read-only in Test Manager. Alternatively, you can select a Requirement from the dropdown list if you want to assign the test case to a specific requirement in Test Manager.

Adding manual steps to test cases

In addition to the automation, you can also include manual steps within test cases. These manual steps provide instructions for executing specific actions during the testing process. When you create or edit a test case, you can add manual steps, describe the action, expected behavior, and define clipboard values, so you don't have to manually type into fields.

Visit Manual test cases to learn how to add manual steps to test cases inside Test Manager.

Uploading documents

In Test Manager, you have the option to upload relevant documents as attachments to test cases.

To upload documents, choose from the following options:

Option	Description
Manual upload	Follow the steps below: Open your project in Test Manager. Navigate to one of the following artefacts: Requirements Test Case Test Set Click an artefact key in the list to open it. Go to the Documents tab. Click the Add document button and choose a file or drag & drop it directly in the page. The file is added to your test.
Attach Document activity	Add the Attach Document activity in your Studio automation. The attachments will appear inside the Attachments tab on the Execution page after execution.

Cloning test cases

To easily create multiple similar test sets, you can also clone individual test cases. To clone a test case:

Select More Options for the test case that you want to duplicate, and then Clone.
Choose if you want to also clone related information, such as documents, labels, or assignments to requirements.
Select Clone to save your changes.

Managing test cases

Test Manager provides a range of actions that can be performed on individual test cases:

View an overview of a test case when you select its key. This takes you to the Overview page.
Access the log of the latest result of the test case. Select Open execution log for a test case and you can see details about the latest test execution.
Delete test cases.
Unlink automation.
Clone test cases.

Related articles

Creating test sets

Test Sets in Test Manager are used to group test cases and define which tests should be executed together in a single run. They provide a way to organize tests based on their purpose and execution requirements. To create a test set, follow the steps below:

Creating test sets

To create a test set:

Assigning test cases to test sets

After you create a test set, you need to assign test cases to it. To assign test cases to a test set, open the desired test set, and in the Tasks menu select Assign Test Cases.

You can simultaneously assign test cases to a test set in two different ways:

Using Static assignment - manually select the test cases that you want to link.
Using Dynamic assignment - input the label of the test cases that you want to assign. Whenever an execution is started, all test cases which have at least one of the selected labels assigned will be added to the execution.

The animated image below shows how to create a test set and assign both static and dynamic test cases to it.

Configuring test sets to run from a specified execution folder

Test sets can be set to run from either a default or a specified execution folder. This allows you to exclusively execute test cases that are part of that particular folder. Moreover, you also have the option to specify particular packages and their versions from which the test cases will be exclusively run. To use this capability, follow these steps:

Check the tenant level settings:
1. Visit Test Manager, select Settings from the header, and then go to the General tab.
2. Check the Allow legacy execution context setting:
  - If the setting is enabled: Test cases run without a specific execution folder.
  - If the setting is disabled: Test cases can run only from a specific Orchestrator execution folder, and from a specified package and version.
Set a default execution folder in the project settings:
1. Go to Project Settings and select the Automation tab.
2. Set your default execution folder.
  This default folder applies to all test sets unless a unique execution folder is specified.
Select an execution folder for a test set:
1. Navigate to Test Sets and open a test set.
2. In the Test casestab, select Select Automation.
3. Choose a preferred folder, from the Execution folder dropdown list.
4. Select Save to apply the change.
Select a particular package and version:
1. In the Test Cases tab of a test set, select Select Automation again.
2. You can use the following options:
  - Autoselect packages: Selects all available packages in the folder with their latest versions, based on the test cases assigned to the test set.
  - Add automation: Allows you to manually choose a package and its version from the corresponding dropdown lists. Use Select to confirm each package-version pairing.

Linking Orchestrator test sets

You can link your test sets from Orchestrator and execute them in Test Manager. To achieve this, you first need to create the test set in Orchestrator, and assign only automated test cases to it.

Note: This feature will be deprecated starting with April 2025. Visit Orchestrator's upcoming deprecations to learn more information about the deprecation.

After you create the test set in Orchestrator, follow the steps below:

Open your project in Test Manager.
Navigate to Test Sets and then Link.
Select a test set from the list and select Link.

Cloning test sets

In order to speed up your testing management, after you cloned requirements and test cases, you can also clone test sets, so you get to rapidly expand your testing projects. To clone a test set:

Select More Options for the test set that you want to duplicate, and select Clone.
Choose if you want to also clone related information, such as Documents and Labels..
Select Clone.

Related articles

Test sets

Executing tests

In Test Manager, you have the option to execute tests manually or using automations. Manual test executions are performed directly in Test Manager, while automated executions are initiated through Test Manager and carried out via Orchestrator. Before executing test cases, it is necessary to create a test set, which will be used for the execution.

Automated execution

Automated execution refers to test sets created in Test Manager with linked test cases from Studio. Before executing automated tests in Test Manager, make sure you have created the test sets in Orchestrator.

You can execute all test sets using the Execute Automated option. Orchestrator is invoked for test cases linked to Test Manager. To execute test sets linked from Orchestrator, ensure that you create the test sets in Orchestrator.

Executing tests using automations

To execute test sets using automations, perform the steps below:

Open your project in Test Manager and then navigate to Test Sets.
Select a test set and click the vertical ellipsis.
Select Execute Automated.

Manual execution

Manual execution applies to test sets created in Test Manager, including test cases with manual steps. Manual execution can be performed for both Test Manager test sets and linked test sets from Orchestrator.

Manually executing tests

To execute test sets manually, perform the steps below:

Related articles

Executing tests

Analyzing results

Execution in Test Manager provide insights about the execution of test sets. Below you have a breakdown of how you can analyze and work with test results.

Accessing test results

Open Execution in Test Manager to view a list of test executions. Each test execution represents the execution of a test set. The executions are sorted based on the finish date, with ongoing and pending executions displayed at the top.

Execution details

When you select a test execution entry, a detailed view opens. This view displays information such as execution start time, duration, and execution logs. The Results section provides an overview of all individual test results from test cases, named Test Case Logs. This allows you to take actions on individual test results.

Understanding test execution status

Test executions are color-coded to indicate their status:

Green - Test cases that passed.
Red - Test cases that failed.
Grey - Test cases without definitive results, such as those not yet executed within an ongoing test set.

Exploring test results

This section describes the information that you can find as part of the test results, and the further actions that you can take after obtaining the results.

Result	Description
Execution Log	The execution log contains essential information, including assertions, logs, execution details, affected requirements, and attachments. Select the test case key within the Execution page to access the execution log.
Activity Coverage	You can enable activity coverage for automated test executions. This feature provides information on the activities covered during the test execution.
Defect Management Integration	If you have an external defect management system integrated with Test Manager, you can create defect reports directly from the execution logs. Open a test case log, select Tasks, and then Create Defect.
Defect Synchronization	Test Manager allows synchronization of execution results with external tools as part of an ALM tool integration. This synchronization ensures that execution details, logs, timestamps, and other relevant information are shared with the integrated tool.
Create and Unlink Defects	Within the Execution page, you can create defects by accessing test case logs, selecting Tasks, and selecting Create Defect. Additionally, you have the option to unlink defects from an external tool, which detaches the test execution result from the external tool's entry.

Working with test results

By analyzing test executions, you can perform the following actions:

Identify manual or automated test results.
Track the progress of ongoing test executions.
Open the executed test set to review the details.
Examine logs and attachments associated with test executions.
Create defects in your defect management system directly from Test Manager if you have an ALM tool integration.

Note: Execution and their associated data remain unaffected by changes or deletion of test sets.

Related articles

Test results
ALM tool integration

Test Suite User Guide

Was this page helpful?