Creating a single test case execution record

In addition to generating multiple test case execution records automatically, you can create a single test case execution record manually. Test case execution records are used to specify the execution environments for a specific instance of a test case to run a test case instance, and to track the status of each test run.


  1. In the main menu, click Construction > Create > Test Case Execution Record.
    Tip: You can also generate test case and test suite execution records automatically in the Test Case Execution Records or Test Suite Execution Records section of a test case or test suite.
  2. In the Create Test Case Execution Record page, type a name for the new test case execution record.
  3. Select a team area and an owner from the lists. Typically, the owner is the person responsible for running the test.
    Note: You must explicitly enable team areas by going to Manage Project Properties.
  4. Type a description of the test case execution record.
  5. Complete the Overview section.
    1. To set the associated test plan, click the Select Test Plan icon (Add) to apply the test case execution record to a particular test plan, or leave it unassigned. After you select a test plan, by default the Iteration field is populated with the value from the associated test plan.
    2. Required: To set the associated test case, click the Select Test Case icon (Add) to select the test case to which the test case execution record must be assigned.
      Note: A test case execution record must be assigned to a test case. If you selected a test plan for the test case execution record, only test cases associated with that test plan are included in the list.
      After you select a test case, the following fields are automatically populated with values from the associated test case: Default Test Script, Available Test Environments, Priority, Weight, and Estimate. If needed, you can edit these values.
    3. In Default Test Script, select the test script that is associated with the selected test case.
    4. In Iteration, select the test iteration to which the test case execution record must be assigned. Test iterations are defined in the Test Schedule section of the test plan and are only available here when you assign the test case execution record to a particular test plan.
    5. In Available Test Environments, select a test environment that defines the runtime environment. A test environment is a set of saved attributes, for example, a particular browser, operating system, hardware platform, and other attributes for a particular machine. If your project uses channels, available channels appear once a test environment is selected.
    6. Define categories.

      You can use categories to define a hierarchical organization of test plans, test cases, test scripts, and other test artifacts. You can also define subcategories and other category relationships. You can use the default categories that are provided or create your own. To define categories, click the Manage Test Case Execution Record Categories icon (Manage category).

    7. Assign values to the custom attribute fields. If an administrator defined any custom attributes for test case execution records, they display in the Attributes section of the Summary. The field values for custom attributes can be in the format of text, integer, or date. You can sort or filter your test cases by using custom attributes in the same way that you use categories.
  6. Click Save.

What to do next

After you run the test case, you can record the time that was required to complete the test case instance in the Time Spent field. This information can be used to improve estimates of the time required for future test runs and to track the time invested in testing efforts.

You can also subscribe yourself and other team members to receive email notifications for the changes that occur to the test case execution record. For more information, see Receiving email notifications for changes to test artifacts.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki