Manage Test Cases

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 CA Agile Central, test cases can be:

  • Created from a work item which creates an automatic association between the test case and the work item (recommended).
  • Created as a stand-alone test case.
  • Edited to add 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 includes the following:

Use the Test Case summary and detail pages

Summary page

The Test Case summary page provides a summary listing of all test cases in your selected project. When viewed from the User Story detail page using the sidebar link, the summary 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.

On the summary page, you can:

  • Click the new test case icon to create a new test case result for a test case.
  • Click the edit icon to edit the test case or its test case result.

Detail page

The detail page provides a view of an individual test case.

Use the detail page to:

  • View a read-only display of a single test case in its entirety including all current field values and details.
  • Navigate to other work items associated to the test case from the sidebar.
  • Use the Actions button to perform tasks such as edit, new, copy, print, delete, and so on.

The work item field is a hyperlink. Click the hyperlink and easily navigate to the related work item for the test case.

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

Create test cases

Create a test case from a work item (user stories and defects only) to verify successful and acceptable implementation and functionality of the work item. When you create a test case from a work item, CA Agile Central 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. CA Agile Central recommends creating test cases directly from the associated work item.

You can create a test case in CA Agile Central from several locations. This flexibility allows you to progress through work activities and create a test case whenever necessary.

From the Test Cases summary page

  1. From Actions, click New Test Case.
  2. On the Create Test Case editor, complete the fields as necessary.
  3. Click Save & Close.

From the Test Plans summary page

  1. Click the New Test Case new test case icon on the row of the test plan for which you want to add a test case.
  2. On the Create Test Case editor, complete the fields as necessary.
  3. Click Save & Close.

From a work item detail page

  1. From the work item summary page, click a hyperlinked work item name.
  2. On the detail page, click the Test Case link on the sidebar.
  3. On the Test Cases summary page, click Actions, then select New Test Case.
  4. On the Create Test Case editor, complete the fields as necessary.
  5. Click Save & Close.

The Requirement field is automatically populated with the ID and Name of the work item from which you chose to generate the test case.

Add steps to a test case

Add steps to a test case to specify what must be completed in a test case in order for it to be successful. 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.

  1. On the Test Case detail page, click Actions, then Edit.
  2. In the Steps section of the Edit Test Case editor, click the Add a Step Icon add step to specify the number of steps.
  3. Enter each step that must be executed to achieve the state of the system as detailed in the related requirement. You can use the rich-text fields for formatting.
    • Input: Enter the action step of the test. This is a required field.
    • Expected Result: List the expected system response to the action step.
  4. 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: 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.
  5. Click Save & Close.
Note: If you are attempting to import test cases that contain multiple test steps, we recommend that you use the CA Agile Central Add-in for Excel.

Add defects to test cases

You can create a new defect from a test case from the following locations:

  • In Quality → Test Cases
    • Click the FormattedID of the test case.
    • Click the Defects link on the sidebar.
    • From the Actions drop-down menu, select New Defect.
  • On a test case under a test set on the Iteration Status page.
    • On the grid view, click the gear menu on the test case.
    • Select Add Child, then select Defect as a the Child Type.

Edit a test case

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.

Edit a test case from any of the following locations. Each location provides two access routes to editing a test case: the summary and detail pages.

Delete a test case

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

My Test Cases

The My Test Cases app is 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.

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 highlighted in red on the full screen editor.

Field Description
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.
Test Folder Add, remove, or change the test folder to which this test case is assigned. Each action creates 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.
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.

To manually associate a work item, click the Choose choose icon and select a work item from the chooser window.

Type Specify the type of test that is being performed, such as regression, acceptance, and so on.
Method Select either Manual or Automated to indicate the method of testing used for the test case.
Priority Specify 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. 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 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.
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.
Custom Fields This section lists any custom fields that have been added to your workspace and their related values. This section only displays if your administrator has added custom fields.
Notes Record any additional information associated with the test case.
Change Description Record any changes made to your test case during an edit. Change Description comments are stored and displayed in the Revision History page.