Adding and Tracking Defects
Locating and repairing defects is an essential phase in application development. Defects can be detected and reported by developers, testers, and end users in all stages of the testing process. Using TestDirector, you can report defects detected in the application, and track them until they are repaired. In this lesson, you will learn about: ➤ How to Track Defects ➤ Adding New Defects ➤ Matching Defects ➤ Updating Defects ➤ Mailing Defects ➤ Associating Defects with Tests ➤ Creating Favorite Views
How to Track Defects
When you report a defect to a TestDirector project, it is tracked through the following stages: New, Open, Fixed, and Closed. A defect may also be Rejected, or Reopened after it is fixed.
When you initially report the defect to the TestDirector project, by default it is assigned the status New. A quality assurance or project manager reviews the defect, and determines whether or not to consider the defect for repair. If the defect is refused, it is assigned the status Rejected. If the defect is accepted, the quality assurance or project manager determines a repair priority, changes its status to Open, and assigns it to a member of the development team. A developer repairs the defect and assigns it the status Fixed. You retest the application, making sure that the defect does not recur.
If the defect recurs, the quality assurance or project manager assigns it the status Reopened. If the defect is actually repaired, it is assigned the status Closed.
Adding New Defects
You can add a new defect to a TestDirector project at any stage of the testing process. In the following exercise you will report the defect that was detected while running the Cruise Booking test.
To add a new defect:
1 Open the TestDirector_Demo project.
If the TestDirector_Demo project is not already open, log in to the project. For more information, see Starting TestDirector, on page 5.
2 Display the Defects module.
Click the Defects tab. The Defects Grid displays defect data in a grid. Each line in the grid displays a separate defect record.
3 Open the Add Defect dialog box.
Click the Add Defect button. The Add Defect dialog box opens. Note that fields that are marked in red are mandatory.
4 Summarize the defect.
In the Summary box, type a brief description of the defect. For example, type: Unable to reserve a cruise from the Cruise page.
5 Specify the defect information.
In Category, specify the class category of the defect. Select Defect.
Skip the Detected By box. This field indicates the name of the person who detected the defect. By default, the login user name is displayed.
Skip the Project box. This field indicates the name of the project in which this defect was found. Accept the default value.
In Severity, specify the severity level of the defect. Select 2-Medium.
Skip the Reproducible box. This field indicates whether the defect can be reproduced under the same conditions in which it was detected. Accept the default value.
In Subject, specify the subject in the test plan tree to which the defect is related. Select Cruises.
Skip the Detected on Date box. This field indicates the date on which the defect was found. By default, todays date is displayed.
In Detected in Version, specify the application version in which the defect was detected. Select Version 1.01.
Skip the Status box. When you initially add a defect to a project, it is assigned the status New.
Skip the Regression field. Accept the default value.
6 Skip the user-defined fields.
Click the Next Page arrow. For the purpose of this exercise, skip the following fields: Language, Browser, and Operating System.
Click the Back Page arrow.
7 Type a detailed description of the defect.
In the Description box, type a description of the defect. For example, type: The defect was detected in the Cruise Booking test. When you click the Now Accepting Reservations button, the Flight Finder page opens instead of the Cruise Reservation page.
8 Attach the URL address for the Mercury Tours page where the defect was detected. Click the Attach URL button. The Attach URL dialog box opens.
Type the URL address of the Mercury Tours page. For example, type: http://[server name]/mtours/servlet/com.mercurytours.servlet.ReservationServlet
Make sure to replace [server name] with your actual TestDirector server name.
Click OK. The URL appears above the Description box.
9 Spell check your text. Place the cursor in the Description box, and click the Check Spelling button. If there are no errors, a confirmation message box opens. If errors are found, the Spelling dialog box opens and displays the word together with replacement suggestions.
10 Add the defect to the TestDirector project.
Click the Submit button. A confirmation message box indicates that the defect was added successfully. Click OK.
11 Close the Add Defect dialog box.
Click Close. The defect is listed in the Defects Grid.
Tracking the repair of defects in a project requires that you periodically update defects. You can do so directly in the Defects Grid, or in the Defect Details dialog box. Note that the ability to update some defect fields depends on your permission settings as a user.
In this exercise you will update your defect information.
To update a defect:
1 Display the Defects module.
Click the Defects tab.
2 Update the defect directly in the Defects Grid.
To assign the defect to a member of the development team, click the Assigned to box that corresponds to the defect and select james_td from the Assign to list.
3 Open the Defect Details dialog box. Click the Defect Details button. The Defect Details dialog box opens.
4 Change the severity level of the defect.
Select 5-Urgent from the Severity list.
5 Add a new R&D comment to explain the change in the severity level.
Click the Description tab.
Click the Comment button. A new section is added to the R&D Comment box, displaying your user name and the current date.
Type: This defect also occurs in Mercury Tours version 1.0.
6 View the Attachments.
Click the Attachments tab. Note that the URL attachment is listed.
7 View the History.
Click the History tab to view the history of changes made to the defect. For each changed field, the date of the change, the name of the person who made the change, and the new value are displayed.
8 Close the Defect Details dialog box.
Click OK to exit the dialog box and save your changes.
You can send an e-mail about a defect to another user. This enables you to routinely inform development and quality assurance personnel about defect repair activity.
In the following exercise, you will e-mail your defect.
To mail a defect: 1 Display the Defects module. Click the Defects tab.
2 Select a defect.
3 Type a valid e-mail address.
In the To box, type your actual e-mail address.
4 Type a subject for the e-mail.
In the Subject box, type a subject for the e-mail.
5 Include the attachments and history of the defect.
In the Include box, select Attachments and History.
6 E-mail the defect.
Click Send. A message box opens. Click OK.
7 View the e-mail.
Open your mailbox and view the defect you sent.
Associating Defects with Tests
You can associate a test in your test plan with a specific defect in the Defects Grid. This is useful, for example, when a new test is created specifically for a known defect. By creating an association, you can determine if the test should be run based on the status of the defect. Note that any requirements covered by the test are also associated with the defect.
You can also create an association during a manual test run, by adding a defect. TestDirector automatically creates an association between the test run and the new defect.
In the following exercise, you will associate your defect with the Cruise Booking test in the Test Plan module, and view the associated test in the Defects Grid.
To associate a defect with a test:
1 Display the Test Plan module.
Click the Test Plan tab.
2 Select the Cruise Booking test.
In the test plan tree, expand the Cruise Reservation sub-folder under Cruises.
Right-click the Cruise Booking test in the test plan tree or Test Grid, and choose Associated Defects.
The Associated Defects dialog box opens.
3 Add an associated defect. Click the Associate button. The Associate Defect dialog box opens.
Click the Select button to select your defect from a list of available defects. Click the Associate button.
An information box opens. Click OK.
Click Close to close the list of available defects. Your defect is added to the list.
Click Close to close the Associated Defects dialog box.
4 View the associated test in the Defects Grid.
Click the Defects tab.
Select your defect in the Defects Grid, and choose View > Associated Test. The Associated Test dialog box opens.
➤ The Details tab displays a description of the test.
➤ The Design Steps tab lists the test steps.
➤ The Test Script tab displays the test script if the test is automated.
➤ The Reqs Coverage tab displays the requirements covered by the test.
➤ The Test Run Details tab displays run details for the test. This tab is only available if the association was made during a test run.
➤ The All Runs tab displays the results of all test runs and highlights the run from which the defect was submitted. This tab is only available if the association was made during a test run.