Manage Test Cases

Print this topicEmail this topicSave as PDF

A test case is a complete technical specification which defines how the system should perform as specified in the requirements. You can generate test cases from work items. A work item is considered complete when all associated test cases pass.

In Rally, test cases can be:

  • Created from a work item thereby creating an automatic association between the test case and the work item (recommended) or as a stand alone test case.
  • Edited to add additional information or update changes as your requirements evolve.

Your ability to manage a test case is dependent upon the user role and permissions you have been assigned for the workspace.

Test cases consists of the following topics:

Create test cases

Create a test case from a work item to verify successful and acceptable implementation of the work item—to verify the work item functions as designed. Create test cases from user stories and defects. When you create a test case from a work item, Rally creates an automatic association between the work item and the test case. View the association in the sidebar of either the work item or the test case. You can create a stand alone test case, but there is no automatic association from the test case to any work item. Rally recommends creating test cases from the associated work item.

You can create a test case in Rally from many locations. This flexibility allows you to progress through work activities and create a test case whenever you need it from logical positions within the Rally application.

Detail and save the test case when your edits are completed. Notice during your editing that the Requirement field is automatically populated with the ID and Name of the work item from which you chose to generate the test case. An automatic association has been made between the work item and the test case.

Add steps to a test case

Add steps to the test case during the initial creation of the test case, or by using the Edit function of the test case. For each input executed, there is an expected system state that results from the input. All combinations of user input and expected system result culminate in the final Validation step which is the actual condition that is being tested.

The steps section of the test case records:

  • Steps: Enter each step that must be executed to achieve the state of the system as detailed in the related requirement. Select the Add a Step Icon add step to specify the number of steps.
    • Input: Log the action step of the test.
    • Expected Result: List the expected system response to the action step.
  • Validation: After all steps for the test case have been added, 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 - Log the action step of the test. This is the activity that will produce the Expected Result.
    • 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.


Click Save & Close when finished.

Edit a test case

When you edit a test case, you can modify information such as attribute values and textual descriptions, reorder test case steps , or add and remove steps. Rally offers multiple locations from which you can edit a test case.

Delete a test case

To delete a test case:

  1. Access the Detail page of the test case you want to delete.
  2. From the Actions button, select Delete.

My test cases

My test cases is part of your personalized work bench, and is accessed from the My Home tab. Only those test cases that list you as the owner are displayed in this view. Use this view as your daily test case workplace.

From this view you can:

  • Select one of the multiple predefined Quick Views to easily assemble your test cases into a meaningful display. Click the drop-down arrow on the selection box in the upper left hand corner to display the saved My Test Case Quick Views selections. Highlight your selection and your display refreshes to reflect your chosen view. Use filter and sort to further refine your view.
  • Create your own Custom Views.
  • Expand/collapse the hierarchical view of all test cases and the related last test case result for each test case where available.
    • Expand the Test Case Summary view by clicking the + in the All column. The most recent test case result for each test case appears. The Result Notes for the test case are displayed under the Name field. Click the hyperlinked Last Build entry to navigate directly to the latest test case result detail.
    • Create a new test case result by selecting the new test case icon for the desired test case.
    • Edit a test case or its test case result by clicking the edit icon on the right side of the work item line.
  • Use the Copy copy icon to copy an individual test case to another test case.

View the Test Case Summary and Detail pages

Summary page

The Test Case Summary page provides a summary listing of all test cases represented in Rally and is the gateway to viewing individual test case details and their associations. When viewed from the User Story Detail page using the sidebar link, the test case page displays all of the test cases directly associated with the user story and its child user stories. This allows you to work with all of the test cases that directly or indirectly affect the user story.

Use the Summary page to:

  • Select one of the multiple predefined Quick Views to easily assemble your test cases into a meaningful display. Click the drop-down arrow on the selection box in the upper-left corner to display the saved Quick Views. Highlight a list item and your display refreshes to reflect your chosen view. Filter and sort to further refine the view.
  • Create your own Custom Views.
  • Expand/collapse the hierarchical view of all test cases and the related last test case result for each test case where available.
    • Expand the test case Summary view by clicking the + in the All column. The most recent test case result for each test case appears and is displayed under the Name field. Click the hyperlinked Last Build entry to navigate directly to the latest test case result detail.
    • Create a new test case result by selecting the new test case icon for the desired test case.
    • In the expanded view, click the edit icon to edit the test case or its test case result.
    • Use the Copy copy icon to copy an individual test case to another test case.
      • To disassociate a test case from a Test Set, click the remove icon. All results associated with the test case will also be disassociated.

Detail page

The Detail page provides a view of an individual test case. From here you can:

  • View a read-only display of a single test case in its entirety including all current field values and details.
  • Perform multiple activities on the test case.
  • Navigate to other work items associated to the test case. The sidebar located on the left of the page displays any associated artifacts related to the current test case. Click any link to navigate to a summary view of the related artifacts of the indicated type. This Summary view offers all actions of the typical work item Summary view.
    • Use the show show and hide hide icons to control the Sidebar display.
  • Click the url URL icon in the upper-left corner of the Detail page to open a new Detail test case page with the complete URL to this work item. From here you can copy the URL to use as a reference link in email to team members, or attachments to other work items, and so on.
  • Use the Actions button located in the upper right of the test case page to select action options such as Edit, New, Copy, Print, Delete, and other specific actions directly from the Detail page.
    • As you navigate through the associations, the Actions button menu options vary in relation to the artifact you are viewing. The top section of the menu options apply to the root artifact (in this case the test case), while the lower half of the options apply to the associated work item.

Notice that the work item field is presented in a hyperlink format. Click the hyperlink and easily navigate to the related work item for the test case.

When copying a test case on the test case detail page, the copy is not automatically scheduled.

Test case fields

Required fields are highlighted in red on the full screen editor.

Use the attributes to help manage your test cases. Once the attribute values have been set, you can filter and sort on these values from the test case Summary screen to display your test cases in a meaningful order.

Field Description
General
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.
Name A textual Name of the test case. The red highlight of the field Name indicates that this is a required entry field.
Description Use this Rich Text Format field to record a description of the test case. You can copy and paste images in this field.
Attachments Browse for a file to attach to your work item details.
Attachments Description Provide additional text information (up to 256 bytes) to describe your attachment.
Owner Specify the owner of the test case.
Package Select a package name to logically group related work items into a common container. The Package names can be customized by your subscription administrator.
Project Select a project from the drop-down list.
Folder Use this field to add, remove or change the Test Folder to which this test case is assigned. Each action provides an automatic revision entry. NOTE: This field is displayed only if your Subscription includes Quality Manager.
Test case
Objective Detail the objective of the test case in this Rich Text Format field.
Work item The work item that is associated to the test case. 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 is displayed. You may also set the association yourself. Click the Choose choose icon next to this field and the Choose a work item window appears listing all available work items contained in the project. Click the radio button next to a work item and click Choose. The test case is now associated to the work item and is displayed in the Sidebar of both work items. The association can be changed at any time by using the previous procedure.
Type Specify the type of test that is being performed such as regression, acceptance, and so on.
Method Select the Manual or Automated radio button to indicate the method of testing used for the test case.
Priority Select a value from the drop down list that indicates the importance of this test case. These values can be customized by your subscription administrator.
Risk Specify the level of risk associated with the test case.
Steps Validation Input and Validation Expected Result represent the actual steps entered for the test case and each validation point.
Result
Last Verdict This read only field displays 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 Build A textual field that displays 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 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 when viewing the test case detail.
Custom
Custom Fields Lists any custom fields that have been added to your workspace and their related values. If no Custom Fields have been added, this section does not display.
Notes
Notes Textual field for recording additional information associated with the test case
Revision
Change Description Use the Comment field to record any changes made to your test case during an edit. Change Description comments are stored and displayed in the Revision History page. Note: Changes made to the test case are also systematically captured for Revision History.
© 2012 Rally Software Development Corp | Legal