Before you create a test pass (with Windows Embedded Compact Test Kit--CTK), you must create a template to base your test pass on. This section describes what a test pass is, how to create a test pass template, and how to create a test pass from a template.

What is a Test Pass?

The Windows Embedded Compact Test Kit uses the concept of a "test pass" as a container for a collection of test suites, which are collections of test cases. The test cases in a test pass can be run all together in one pass or run selectively.

A test pass provides a way to organize your testing according to the way you run your tests. For example, you could have one test pass called SetTopBox that contains all of the multimedia, file system, Ethernet, and display tests that you want to run on your device platform. Then you could have another test pass called SetTopBox_Multimedia that contains only the multimedia tests. You would use the SetTopBox_Multimedia test pass if you want to run only the multimedia tests and the SetTopBox test pass if you want to run the complete set of tests.

A test pass can be saved and reused at a later time. Saved test passes will be preserved during upgrades to new versions of the Windows Embedded Compact Test Kit.

To create a test pass, you first create a test pass template to base your test pass on.

Creating a Test Pass Template

A test pass is created from a test pass template. Once you've created a test pass template you can add and remove test cases from the template.

You can organize test cases into logically related test pass groups using the Windows Embedded Compact Test Kit (CTK) to create test pass templates. You can view these groups in the Test Case Explorer on the Test Pass Templates View tab.

There are two categories of test pass templates:

  • Microsoft Windows Embedded Templates, which are provided by Microsoft and organized into the following groups: Basic Verification, Functional, Performance, and Windows Embedded Compact.
    • The Basic Verification, Functional, and Performance templates are subsets of all tests available in the CTK. The selection of the tests that make up each test pass template is based on relevance to the goal of that test pass.
    • The Windows Embedded Compact template contains all the tests available in the CTK.
  • My Templates, which are all the templates created by you.

You cannot edit the Microsoft Windows Embedded Templates, but you can edit the My Templates that you create using the Test Manager. For more information about the Test Manager, see Managing Tests.

Creating a New Test Pass Template

You use the Test Manager to create new and edit existing test pass templates. For more information about the Test Manager, see Managing Tests.

To create a new test pass template:

  1. In Windows Embedded Compact Test Kit, on the File menu, point to New, and then click Test Pass Template.
  2. On the right side of the Test Manager window that appears, on the Test Pass Templates tab, under Edit Templates, click the New button.
  3. In the new template that appears, type the name you want to rename the template.
  4. In the Test Case Explorer tree view display area, double-click Windows Embedded Test Catalog to expand the catalog tree.
  5. Click on a test case tree node or an individual test case, and then click the Add > button to add the selected test case to your new template.
  6. Continue to add test cases from the Windows Embedded Test Catalog until your template is complete.
  7. If a test case needs to be removed, click on a test case tree node or an individual test case in your new template to highlight the node or test case you want to remove, then click the < Remove button.
  8. Click Done to exit Test Manager.

Copying an Existing Test Pass Template

The Windows Embedded Compact Test Kit (CTK) provides prebuilt test pass templates that you can copy to create your own templates. The provided templates are the Windows Embedded Compact template that is based on the test cases in the Windows Embedded Test catalog and a Desktop template. You can copy test pass templates that you create as well.

To copy an existing test pass template:

  • In Windows Embedded Compact Test Kit, on the File menu, point to New, and then click Test Pass Template.

The Test Manager window opens displaying the Test Case Explorer on the left side of the window and two tabs on the right side: Test Case Information and Test Pass Templates.

  • On the Test Pass Templates tab, click to highlight the template you want to copy.

Note:   You cannot copy test cases from a template. You can only copy the template as a whole.

  1. Under Edit Templates, click the Copy button.
  2. In the copied template that appears, type the name you want to rename the copied template.
  3. If you want to customize the template, you can add and remove test cases.
  4. Click Done to exit Test Manager.

Creating a Test Pass from a Template

Once you have a created a test pass template, you can create a test pass.

To create a test pass from a template:

  1. In Windows Embedded Compact Test Kit, connect to a device. For more information, see Connecting to a Device.
  2. On the View menu, click Test Pass Templates View.
  3. In the Test Case Explorer window Test Pass Templates View tab, click to highlight the test pass template you want to base your test pass on.
  4. Right-click the highlighted template and then click Use as Current Test Pass on the pop-up menu.  Note: If Use as Current Test Pass is not available on the pop-up menu, you most likely are not connected to a device.
  5. In the Test Pass display window, click the new test Windows Embedded that is highlighted and type a new name.  Note: If a test pass was already in the Test Pass display window, you'll be asked if you want to save the current test pass before a new test pass is created. 
  6. Click the plus sign (+) preceding the test pass name to expand the test pass tree.  The new test pass contains all the test cases that are in the template used to create the test pass.
  7. On the File menu, click Save Test Pass.

Adding a Test Case to a Test Pass

You can add a test case directly to a test pass without adding the test case to a template.

To add a test case to a test pass

  • 1. In Windows Embedded Compact Test Kit, connect to a device. For more information, see Connecting to a Device.
  • 2. On the File menu, point to Open, and then click Test Pass.
  • 3. In the Open dialog box, select a test pass file and then click Open.

Note   If a test pass was already in the Test pass display window, you'll be asked if you want to save the current test pass before a new test pass is created.

  • 4. In the Test pass display window, on the View menu, click Test Case Explorer.
  • 5. In the Text Case Explorer window, select a test case node or a test case from the Windows Embedded Test Catalog tree.
  • 6. Drag and drop the selected test case or test case node onto the Test Pass display window. If you select a test case node, the node and all children of the node are copied to the current test pass.
  • 7. To save the test pass, on the File menu, click Save Test Pass.

See Also