Manage Test Plans
The test plan summary view provides testers with a single location to organize and manage test cases into folders. When planning your test effort use test plans to assemble test cases in a hierarchy of folders, run the tests in groups, log test results and defects then see the summarized results.
This topic includes the following:
- Create test folders
- Edit test folders
- Create hierarchical test folders
- Delete test folders
- Add test cases to test folders
- Add test folders to test cases
- Remove a test case from a test folder
- Run test cases
- Test folder status
Create Test Folders
Test folders allow you to organize and group your tests into functional areas.
With the Editor:
- Click the Actions button located in the upper right of the page then select New Test Folder. The editor displays.
- Enter the name for your new test folder.
- Choose Save & Close, Save & New, or Save.
Inline:
- Click the Actions button located in the upper right of the page then select Inline Add. A new row displays in the summary view.
- Enter the name for your new test folder.
- Click a row action icon:
Edit Test Folders
With the Editor:
- Click the edit icon
of the test folder you want to edit. The editor displays. - Complete your edits.
- Choose Save & Close, Save & New, or Save.
Inline:
- Double click the test folder row you want to edit. The row changes to edit mode.
- Complete your edits.
- Click
to save your test folder or click
to cancel.
Create Hierarchical Test Folders
To organize your test cases further you can create a hierarchy of test folders . The hierarchy is created by assigning a parent or child test folder.
Assign a Parent Test Folder:
- Click the edit row action icon of the child test folder. The editor displays.
- Click the Choose
icon in the parent field. The test folder chooser displays. - Select the test folder to be the parent.
- Click Choose. The test folder chooser closes and the editor displays the selected test folder name in the parent field.
- Click to save your edit.
- Perform these steps to reassign a child folder to a different parent.
The test plan summary page displays the child test folder under the parent. Expand the parent test folder to see the child test folder.
Create Child Test Folders:
- Click the Inline Add Test Folder
icon of the parent test folder. A new row displays in the summary view. - Enter the name for your child test folder.
- Click a row action icon:
Delete Test Folders
Use the delete row action to delete test folders from the test plan summary view.
- Click the Delete
icon. - A confirmation dialog displays.
- Click OK to continue with the delete or click Cancel.
The test folder no longer displays on the test plan summary page.
Child test folders are not deleted with parent test folders. The parent field of the child story is cleared and displays in the test plan summary view.
Add Test Cases to Test Folders
Create new or add existing test cases to test folders.
Create New Test Cases
With the Editor:
- Click the New Test Case icon
to display the test case editor. - Enter the test case information. The test folder field is automatically updated.
- Choose Save & Close, Save & New, or Save.
The test plan summary page displays the new test case under the test folder. Expand the test folder to see the associated test cases.
Inline:
- Click the Inline New Test Case icon
to display a new row in the summary view. - Enter a name for the test case.
- Click a row action icon:
Add Existing Test Cases
- Click the Add Test Cases row action icon
to display the test case chooser. - Place a check mark in the test case(s) you want to associate to the test folder.
- Click Choose.
The test plan summary page displays the new test case under the test folder. Expand the test folder to see the associated test cases.
Add Test Folders to Test Cases
Add test folders to test cases through the test case editor.
- From the test case editor click the Choose
icon in the Test Folder field. The test folder chooser displays. - Select the test folder to associate to the test case.
- Click Choose. The test folder chooser closes and the editor displays the selected test folder name in the test folder field.
- Save your edit.
- Perform these steps to move a test case to a different folder.
View the test folder from the test plan summary view. Expand the test folder to see the associated test cases.
- Test cases can only be added to a single test folder.
- Only test cases from the selected project can be added to a test folder.
- The chooser only displays test cases that reside in the selected project.
- If a test case contained within a test folder is moved to a different project, the test folder field of the test case is cleared.
Remove a Test Case from a Test Folder
Remove a test case from a test folder through the test case editor.
- From the test case editor click the Clear
icon in the test folder field. - The test folder no longer displays in the test folder field.
- Save your edit.
The test case no longer displays in the test summary page under the test folder.
Run test cases
Run test cases contained in a test folder from a single location.
- Click the Run
row action icon for a test folder. - The test cases that are contained in the test folder are listed in the test run view. From this view you can create a test case result, add a defect or edit the test case.
Test Folder Status
The test plan summary view displays a status bar
for each test folder. The status bar rolls up the test results of the test cases in the folder as well as results in child folders.
Hover your mouse over the status bar to display details.
- Green = passing test cases
- Red = failing test cases
- Yellow = all other test case result verdicts not passing or failing (For example, inconclusive, error or custom values.)
- White = not run

