Test Cases

A test case is a complete technical specification which defines how the system should perform as specified in the requirements. You can associate test cases with work items. A work item is considered complete when you have indicated that all associated test cases pass.
Your ability to manage test cases is dependent upon the user role and permissions you have been assigned for the workspace.
If you want to import test cases, you can use the
Rally
Add-in for Excel
.
You can include the My Test Cases app as part of your personalized dashboard. Only those test cases that list you as the owner display. Learn more.
The Test Cases page displays in a list view that you can customize. Learn more.
This section includes the following topics:
Creating Test Cases
To save time and have easier tracking,
Rally
recommends creating test cases directly from an associated work item. When you create a test case from a work item,
Rally
creates an automatic association between the work item and the test case. You can then view the association in the detail editor of either the work item or the test case. When you create a standalone test case, you must manually associate the test case to a work item.
You can create a test case in
Rally
from several locations. This flexibility allows you to progress through work activities and create a test case whenever necessary. You can create test cases from the following pages:
  • Test Cases
  • Quality Management
  • Work Views
After creating a test case, you can enter the test case results when you have them. Learn more.
Scheduling Test Cases
The only way you can schedule a test case within an iteration is to include it in a test set.  Test sets are groups of tests that you can associate within an iteration. Learn more.
Create and Associate a Test Case with a Work Item
You can create a test case while you are viewing another work item such as a user story or defect and automatically associate the test case with the work item. When you create a test case in this way, the Work Product field of the test case is automatically populated with the ID and name of the work item from which you chose to generate the test case.
You can quickly create a work item by using the toolbar. Within most list and board views, select
Add New
, complete the suggested fields, and then select
Create
.  Some suggested fields have default values if the field is required. You can edit the work item to add details at a later date.
You can use this method to add multiple items in succession such as multiple peer or child work items for a selected work item.
If your workspace administrator has made some work item fields required, this feature is not available.
Follow these steps:
  1. Navigate to a page that contains the work item of interest.
  2. Select the FormattedID of the work item.
  3. Select the
    Test Cases
    test cases collection icon to open the Test Cases page.
  4. Select
    Add New
    from the toolbar.
  5. Select
    Create with details
    to view the item in the detail editor and complete any necessary fields.
    Required fields are marked with an asterisk (*).
  6. Select
    Create
    .
Import Test Cases
From the Test Cases page, you can import test cases with test steps using
Import/Export
Actions icon . Learn more.
Associate an Existing Test Case with a Work Item
You can associate an existing test case with a work item. When you do so, the work item's name and ID are automatically populated in the test case's work product field so that you can track the association.
Follow these steps:
  1. Navigate to a page that contains the work item of interest.
  2. Select the FormattedID of the work item.
  3. Select the
    Test Cases
    test cases collection icon to open the Test Cases page.
  4. Select
    Link Existing
    link existing icon from the toolbar.
  5. Within the
    Choose
    dialog box, select a test case to associate. You can filter this dialog box by test folder and project and use the search field to identify the test case you want to associate.
  6. Select the work item(s) you want to associate and select
    Done.
Associate an Existing Test Case with a Test Plan (Test Folder)
You can associate an existing test case with a test plan (test folder). It is recommended that you associate test cases with both a work item and a respective test plan or test set to help you better track your test efforts.
You can add test cases to a test plan by adding them as children of the test plan.
You can also associate a test case with a test plan (test folder) by dragging and dropping it onto a test folder.
Follow these steps:
  1. Select
    Quality, Quality Management
    .
  2. In the
    Test Folders
    pane, select the check box of the folder to which you want to associate a test case.
  3. Select
    Link Existing
    link existing icon from the toolbar.
  4. Within the
    Choose
    dialog box, filter by test folder and project and use the search field to identify the test case you want to associate.
  5. Select the work item(s) you want to associate and select
    Done.
Create a Standalone Test Case
You can create a test case without associating it with a work item. Although
Rally
does not recommend this approach, it may suit your process if you have a need to store test cases independently of work items.
You can always edit the test case later to associate with a work item.
Follow these steps:
  1. Select
    Quality, Test Cases
    .
  2. Select
    Add New
    from the toolbar.
  3. Select
    Create with details
    to view the item in the detail editor and complete any necessary fields.
    Required fields are marked with an asterisk (*).
  4. Select
    Create
    .
Associate an Existing Standalone Test Case with a Work Item
If you created a standalone test case, you can edit it to ensure it is associated with a work item.
Follow these steps:
  1. Navigate to a page that contains the work item of interest.
  2. Select the FormattedID of the work item.
  3. Within the detail editor, navigate to the
    Work Product
    field and select the + icon to view the
    Choose
    dialog box.
  4. Within the Choose dialog box, select a work item to associate. You can filter this dialog by project and use the search field to identify the item you want to associate.
  5. Select the work item(s) you want to associate and select
    Done.

Add Test Case Details

Rally
provides you the flexibility to add different details to your test case. You can document expected preconditions and post conditions of test as well as add detailed validation expectations. You can also add steps to follow to complete the test itself.
Follow these steps:
  1. Select
    Quality, Test Cases
    .
  2. Select the FormattedID of the work item.
  3. Select the
    Steps
    test steps collection icon to open the Test Steps page.
  4. Within the
    Conditions
    section, complete any information about expected pre- or post- conditions.
  5. To add a specific step for the test, select
    + Add New
    at the bottom of the sections.
    1. in the
      Input
      field, enter the step to be followed and then use the
      Expected Result
      field to enter the expected result of the step.
    2. After completing both fields, select the
      Create
      button to the far right.
    3. Repeat these steps for all additional steps you want to include.
      Your changes are automatically saved.
  6. After you've entered all the steps for the test case, enter a validation step. This is the one step that evaluates the status of the execution of the test case and sets the local verdict of the test case.
    • Validation Input: Enter the action step of the test. This is the activity that will produce the Expected Result. This is a required field.
    • Validation Expected Result: List the response that must be obtained in order to verify the correct performance of the system. The Expected Result is the comparator that demonstrates that the system has accurately fulfilled the designed functionality.
    Your changes are automatically saved.

Adding Defects to Test Cases

You can associate defects with test cases. When doing so, you can choose to create a new defect or select an existing defect to associate with the test case.
Create a New Defect to Associate with a Test Case
You can associate new defects to a test case by viewing a test case in the detail editor or using the toolbar when viewing a test case in a list view. These instructions explain how to associate a defect with the detail editor.
You can quickly create a work item by using the toolbar. Within most list and board views, select
Add New
, complete the suggested fields, and then select
Create
.  Some suggested fields have default values if the field is required. You can edit the work item to add details at a later date.
You can use this method to add multiple items in succession such as multiple peer or child work items for a selected work item.
If your workspace administrator has made some work item fields required, this feature is not available.
Follow these steps:
  1. Select
    Quality, Test Cases
    .
  2. Select the FormattedID of the work item.
  3. Select the
    Defects
    defects collection icon to open the Defects page.
  4. Select
    Add New
    from the toolbar.
  5. Select
    Create with details
    to view the item in the detail editor and complete any necessary fields.
    Required fields are marked with an asterisk (*).
  6. Select
    Create
    .
Associate an Existing Defect with a Test Case
You can associate an existing defect with a test case when you view the test case in the detail editor.
Follow these steps:
  1. Select
    Quality, Test Cases
    .
  2. Select the FormattedID of the work item.
  3. Select the
    Defects
    defects collection icon to open the Defects page.
  4. Select
    Link Existing
    link existing icon from the toolbar.
  5. Within the Choose dialog box, select a defect to associate. You can filter this dialog by project and use the search field to identify the item you want to associate.
  6. Select the work item(s) you want to associate and select
    Done.
Edit a Test Case
When you edit a test case, you can update any information associated with the test case including its associated work item (the
Work Product
field). When you edit a test case, you can modify information such as field values and textual descriptions, reorder test case steps, or add and remove steps.
When a work item has attachments, the list of attachments is sorted from newest to oldest. If you have 200 or more attachments, only the newest 200 display on the page. Older attachments still exist in
Rally
; however, you must delete newer ones to view those hidden from view on the page.
Follow these steps:
  1. Navigate to a page that contains the work item of interest.
  2. Select the FormattedID of the work item.
  3. Within the detail editor, make any changes.
  4. Select
    Save
    .

Delete a Test Case

You can delete a test case.
Follow these steps:
  1. Navigate to a page that contains the work item of interest.
  2. Select the check box of the work item(s).
  3. Select
    Delete
    delete icon from the toolbar.
    The work item is moved to the Recycle Bin.

Use the My Test Cases App

You can include the My Test Cases app as part of your personalized dashboard. Only those test cases that list you as the owner display. Use this app as your daily test case workplace.
Learn more about adding apps to your dashboard.
For more information on the My Test Cases app, see the App Catalog.

Test Case Fields

The following fields are available to help you describe or add detail to a test case. You can set these field values when creating or editing a test case.
Required fields are marked with an asterisk (*).
ID
A system-generated ID for the test case. The ID consists of a tag prefix and a numerical value. The tag can be customized by your system administrator to reflect a differentiating prefix for each work item defined in your project, such as US for user story, DE for defect, and so on.
Name
Enter a name of the test case. This is a required field.
Color
Optional color indicator for the test case.
Owner
The owner of the test case.
Project
The project that contains this test case. This is a required field.
Description
A description of the test case.
Test Folder
Add, remove, or change the test folder to which this test case is assigned. Each action creates an automatic revision entry.
Objective
Detail the objective of the test case.
Work Product
Specify the work item that is associated to the test case, such as a user story or defect. If you generated the test case from a work item, this association is automatically created and the name of the work item from which the test case was generated displays.
Type
Specify the type of test that is being performed, such as regression, acceptance, and so on. This is a required field.
Method
Select either
Manual
or
Automated
to indicate the method of testing used for the test case. This is a required field.
Priority
Specify the importance of this test case. These values can be customized by your subscription administrator.
Steps
Validation Input and Validation Expected Result represent the actual steps entered for the test case and each validation point. Validation Input is required.
Last Verdict
The verdict from the most recent execution of the test case. The field is automatically updated each time the test case is executed. Last Verdict is not displayed during an edit of a test case, but only when viewing the test case detail.
Last Run
The date of the test execution. Last Run is entered on the Test Case Result page and is displayed here as a read-only field.
Last Build
The number of the last software build which was tested. Last Build is entered on the test case result page and is displayed here as a read-only field.
Attachments
Browse for a file to attach to your work item details.
The maximum size of an attachment is currently 50 MB.