Create a Test Pass (Compact 2013)

  • Article

3/26/2014

Before you create a test pass, you must create a template to base your test pass on. This topic 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 (CTK) uses the concept of a test pass as a container for a collection of test suites, which are collections of test cases. A test case is one individual test or, put another way, the particular conditions that the device is tested for and which are labeled by a test name. 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 of the device. 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. Previously 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.

What is a Test Pass Template?

A test pass is created from a test pass template, which is a reusable model that contains a collection of related test passes. After 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, or test suites, by using the CTK to create test pass templates. You can view these groups in the Test Case Explorer pane, which is available from the Test Manager.

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 that you create.

You cannot edit the Microsoft Windows Embedded Templates, but you can edit the templates that you create and store in My Templates by using the Test Manager. For more information about the Test Manager, see Manage Tests.

Create or Edit a Test Pass Template

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

To create or edit a test pass template

  1. In the CTK, on the File menu, point to New, and then click Test Pass Template.

  2. If you want to create a new test pass template, on the right side of the Test Manager window that appears, on the Test Pass Templates tab, under Edit Templates, click the New button. To edit an existing test pass template, select the existing template from Test Pass Templates.

  3. If you create a new test pass template, you can type a new name to rename it.

  4. In the Test Case Explorer tree view pane, expand Windows Embedded Test Catalog.

  5. Click 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 you want to remove a test case, click 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, and then click the Remove button.

  8. Click Done to exit Test Manager.

Copy 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, which contains the test cases in the Windows Embedded Test catalog, and a Desktop template. You can also copy test pass templates that you create to use as a model for a new templates.

To copy an existing test pass template

  1. In the CTK, on the File menu, point to New, and then click Test Pass Template.

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

  2. 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.

  3. Under Edit Templates, click the Copy button.

  4. In the copied template name that is highlighted , type a name to rename the copied template.

  5. If you want to customize the template, you can add and remove test cases.

  6. Click Done to exit Test Manager.

Create a Test Pass from a Template

After you create a test pass template, you can create a test pass.

To create a test pass from a template

  1. In the CTK, connect to a device. For more information, see Connect to a Device.

  2. On the View menu, click Test Pass Templates View.

  3. In the Test Case Explorer window, on the Test Pass Templates View tab, click to highlight the test pass template that you want to base your test pass on.

  4. Right-click the highlighted template, and then click Use as Current Test Pass.

    Note

    If Use as Current Test Pass is not available on the shortcut menu, you most likely are not connected to a device.

  5. In the Test pass display window, click the new test pass with the highlighted default name of Windows Embedded, and then type a new name.

    Note

    If a test pass was already in the Test pass display window, you will be prompted to save the current test pass before a new test pass is created.

  6. In the Test pass display window, expand the test pass tree to view the test cases.

    The new test pass contains all the test cases that are in the template that you used to create the test pass.

  7. On the File menu, click Save Test Pass.

Add 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 the CTK, connect 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 will be prompted to save the current test pass before a new test pass is created.

  4. In CTK, 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 the selected test case or test case node onto the Test pass display window. If you select a test case node, the node and its child nodes are copied to the current test pass.

  7. To save the test pass, on the File menu, click Save Test Pass.

See Also

Concepts

Compact Test Kit Overview