Overview
Labels allow you to group your tests by self-defined criteria for easier sorting and location. Labels are structured as name : value pairs and allow you to tag individual tests with one or more labels.
This article explains how to use the Labels feature in the Catchpoint application. For information on how to leverage Labels in our APIs, consult our REST API Help page which is accessible from the Help menu in the upper-right hand corner of the Catchpoint portal.
Procedure
Add your label in the Label field that is available in Test Properties.
Note: the Label field is only available at the individual test level, and not for Products or Folders.
Each label is a name-value pair separated with a colon : which allows users to categorize them. Example: Production : New York
In the above example, Production is the name which can be treated as a Category, and New York is a value in the "Production" category. Categories/Names are unique; you can have the same value across categories. An example of this would be using both Production : New York and QA : New York A unique color is automatically assigned to each new label Name. These colors then remain the same for all the Name : Value pairs; allowing for easier identification.
Labels are case-insensitive i.e. if you create a new label Environment and later create another label as envirONment; both of these are treated as the same.
Name : Value pairs can only contain letters, numeric characters, underscores, and dashes. International characters are allowed. Labels should NOT contain the following characters: <, >, %, &, \, ?, /
Usage
Labels are used for filtering and/or narrowing down a list of tests. A new option is now available in:
- The search area of the Control Center
- the Test selector in the Analysis module where you can search by Label Name or Label Value.
- Use the format as /label: Label Name or Label Value to search for any test with the specific label.
Note:
- Each label name and value must not exceed 128 characters.
- You can assign up to 100 labels to a single test.