In the category editor, you can define categories and category
values for your project. You can also define relationships between
categories. By assigning categories to artifacts, you can set up a
hierarchical directory structure that keeps you organized and helps
you find individual artifacts.
Before you begin
To add, edit, and delete categories, you must be assigned
to a role that has the Save Category and Save Category Value permissions
enabled.
About this task
You can assign categories to many test artifact types.
You can also define a hierarchical organization of artifacts by establishing
category relationships. To establish category relationships, you define
subcategories, required categories, default categories, and multivalued
categories.
Procedure
- Open the category editor for a type of test artifact. For example, you might open the category editor for test
plans.
- In a project, click the Admin (
) icon in the banner,
and then click Manage Project Properties.
- From the list of properties on the left, expand Artifact
Categories and select the test artifact that you want
to define categories and category values for.
- Click the Create icon (
).
- Type the name of the new category and then click Save.
- Expand a category in the tree.
- Add a category value to the expanded category by clicking
the Create icon (
).
- Type the name of the new category value. For
example, you might add a specific release value, such as R
3.0, as the category value for the Release category.
- Optional: Create a dependency relationship
by using subcategories. When you create a subcategory,
you create a parent-child relationship between two categories.
- Select a category to add a subcategory to, and then
click the action icon beside the category name. Click Create
Sub-Category.
- In the window that opens, select the category from the
list and click OK.
- Assign values to the parent category and the subcategory.
- Assign values to the parent category and the subcategory by selecting
them and clicking the Create icon.
- Expand a parent category, and then assign values to each subcategory.
In this example, the Release subcategory has values of 1, 2, and 3.

- Select a subcategory, click the action icon beside the subcategory
name, and then select Edit Subcategory values.
- In the Edit Subcategory values window, select
the values to associate with the selected category. In this example,
Version 1.0 is assigned to values 1, 2, and 3 of the Release subcategory.

After you click OK, the subcategory
is nested under the category.
You can define up to three levels
of nested categories; for example, Version > Release > Milestone.
If you define three levels, you must explicitly associate values with
the second-level category. If you do not associate values with the
second-level category, when users try to assign the categories in
a test artifact, no options are available. In the Version > Release
> Milestone example, you first define the categories, subcategories,
and values. Then, you must click each of the values that are defined
for the Release category to associate them with the values in the
Milestone category.

- Optional: Define which categories are required. When you make a category that is required, users must select
a value for that category when they complete the Summary section
of a test artifact.
- Select a category.
- Click the down arrow and select Define as
Required.
A small asterisk is added to the name of the category.Note: Required
fields are enforced when test artifacts are created and modified.
Required fields are not enforced when artifacts come from external
tools, such as the automated test execution adapters and the Microsoft Excel plug-in.
- Optional: Define a category as multivalued. By making a category multivalued, you enable more than one value
to be selected when a user completes the summary section of an artifact.
- Select a category.
- Click the down arrow and select Define as
Multivalued.
A small icon is added to indicate that the category is
multivalued.
- Optional: Set a category value as the default
value.
- Select a category value to define as the default value.
- Click the down arrow and select Set as Default.
You can change the default value by clicking Remove
as Default and making another value the default value.
- Click Save.