Defining categories and category relationships

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

  1. Open the category editor for a type of test artifact. For example, you might open the category editor for test plans.
    1. In a project, click the Admin (Administration) icon in the banner, and then click Manage Project Properties.
    2. 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.
  2. Click the Create icon (Add).
  3. Type the name of the new category and then click Save.
  4. Expand a category in the tree.
  5. Add a category value to the expanded category by clicking the Create icon (Add).
  6. 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.
  7. Optional: Create a dependency relationship by using subcategories. When you create a subcategory, you create a parent-child relationship between two categories.
    1. Select a category to add a subcategory to, and then click the action icon beside the category name. Click Create Sub-Category.
    2. In the window that opens, select the category from the list and click OK.
    3. Assign values to the parent category and the subcategory.
      1. Assign values to the parent category and the subcategory by selecting them and clicking the Create icon.
      2. Expand a parent category, and then assign values to each subcategory. In this example, the Release subcategory has values of 1, 2, and 3.

        Associated subcategory values

      3. Select a subcategory, click the action icon beside the subcategory name, and then select Edit Subcategory values.
      4. 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.

        Editing subcategory values

    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.Nested subcategory values
  8. 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.
    1. Select a category.
    2. 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.
  9. 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.
    1. Select a category.
    2. Click the down arrow and select Define as Multivalued.
    A small icon is added to indicate that the category is multivalued.
  10. Optional: Set a category value as the default value.
    1. Select a category value to define as the default value.
    2. 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.
  11. Click Save.


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