Running a test case execution record

You can run tests several ways. One way is by running a test case execution record.

About this task

You can run a test case directly or you can run a test case execution record. When you run a test case directly, a default test case execution record is generated, but it does not specify a test plan, iteration, or test environment unless you select those optional values in the Run Test Case dialog box. If you want the predefined reports to reflect test results by test plan, iteration, or test environment, you can generate test case execution records before running tests.

You create test case execution records in the context of a particular test case. Test case execution records map test planning and environment information to the test case. Therefore, when you run a test case execution record, you run the test in a specific test environment and associate the test run with a specific test plan and test iteration."

You can use test case execution records to run both manual and automated tests. If you have created manual test scripts, you can add those test scripts to a test case and then add test case execution records to the test case. The same is true for any automated tests that you reference from Rational® Quality Manager. In many cases, when you run the test case execution record, you use a test script in a test case that is associated with the test case execution record.

Procedure

  1. In an open test case, open the Test Case Execution Records section.
  2. Select the test case execution record to run.
  3. Run the test case execution record by doing one of these steps:
    • To run the test case execution record as is, click the Run icon Run.
      Note: If using channels, the Test Case Execution Record will run on the first channel to which its Test Environment is related. View a Test Environment in the Test Environment Editor to view its related channels.
    • To choose a different test script to run, in the Test Script column, select the test script that you want to run. Then, click the Run icon Run.
    • To temporarily modify the values of execution variables, choose a build record to associate with the test case result, select records from test data, or pick a channel different from the default one, click the menu arrow next to the Run icon Run and select Run with Options. In the Run with Options dialog box, select the options that you want and then click OK.
    The script execution view opens and an arrow points to the first statement.
    Note: If an automated test script is associated with the test case, select the appropriate adapter to run the test, and then click OK. The script execution view opens, and the test runs automatically. At the end of the test run, the adapter attaches the tool-specific result to the Result Details section of the test case result.
  4. For each step, follow the instructions in the step and then and assign a verdict to the step.

    Possible verdicts include:

    • Pass Pass
    • Fail Fail
    • Inconclusive Inconclusive
    • Blocked Blocked
    • Error Error
    • PermFailed PermFailed
    • Deferred Deferred
    Note: To see the options for Blocked, Error, PermFailed and Deferred, click the arrow next to the Inconclusive icon.
    Tip: To assign the same verdict to all steps that follow the current step, click the Apply All icon Apply all verdict.
  5. Optional: Type the step results in the Actual Results field.
  6. Optional: Add a comment to one or several statements:
    1. From the toolbar, click the Comments icon Comments.
    2. Type your comment in the Write Comments field, and click OK. The Comments icon Comment is displayed in each statement that has a comment.
  7. Optional: Add an attachment to one or several statements. For example, you can create a screen capture of the application under test and attach it to the statement. To attach a file to a statement:
    1. From the toolbar, click the Attachments icon Attachments. The Attachments View window opens.
    2. Browse to the file, and click Open.
    3. Click OK. The Attachment icon Attachment is included within each statement that has an attachment.
  8. If you discover problems with the application under test, submit a defect:
    1. From the toolbar, click the Create New Defect icon Create new defect. The defect form opens.
      Note: If you configured Rational ClearQuest® as your defect provider and you are using Internet Explorer, you might see a Security Warning dialog when you attempt to create a defect. To allow the defect form to open, in Internet Explorer 7 click Yes, or in Internet Explorer 8 click No.
    2. Complete the defect form, and click OK. The Defects icon Defect is included within each statement that has a defect.
  9. When the test run is complete, click Show result to view the test case result.

    If necessary, you can modify the Actual Result and the weight distribution in the test case result. After you edit, be sure to click Save to save your changes.

What to do next

If your organization requires a review of the test case result, you can use the Formal Review section of the test case result to assign reviewers and approvers.


Have a problem or a question? Post it in the Jazz.net forum.