Creating custom generators and categories from Data definitions

You can create custom generators and categories from existing Data definitions in HCL DevOps Test Hub (Test Hub). After you add an existing generator in a field of a Data definition, you can customize the generator parameters that are displayed for the field. You can then save the customized parameters in the Data fabrication catalog as a new generator. You can also save the new generator either in an existing category or save in a new category.

Before you begin

You must have completed the following tasks:

Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to the server projects.
Created a Data definition. See Creating an empty Data definition.
Read about the parameters of the basic generators. See Basic generators.

Procedure

Log in to Test Hub.

The team space that contains your project is displayed.
Click Active projects > My projects > project_name to open the project that contains the test assets.

The Overview page of the project is displayed.
Click Author > Data.

The Data page and the Data navigator panel are displayed.
Open a Data definition in the Edit branch.
Click a generator in the Generator column of a field where you want to customize the configuration.
Perform any modification in the Generator dialog to customize the existing configuration of the selected field.
Click Save to catalog to save the customized parameters in the catalog of the Data fabrication feature as a new generator.
The Add new generator dialog is displayed.
Enter a unique name for the new generator in the Name field.
Test Hub uses the existing generator as the base generator. Therefore, the Base generator list is not editable.
Perform one of the following actions to select the category of the new generator:
- To select an existing category, go to step 10.
- To add a new category, go to step 11.
Perform the following steps to select an existing category:
1. Select an existing category that is displayed in the Category list.
2. Click Create.
  The new generator is added in the existing category and is displayed in the Catalog panel of the data definition.
Perform the following steps to add a new category:
1. Click Add new category in the Category list, and then click Next.
  The Add new generator dialog displays a new set of fields to capture more details about the new category.
2. Enter a unique name in the Category name field where the new generator will be saved in the catalog of Test Hub.
3. Select a color from the available range of colors so that you can identify the new category easily.
4. Select the location to create the new category in the selected folder.
  For example, if you entered MyFolder/MyCategory in the Category name field, and then selected Location as the location to create the category in the folder, then the category is created under the Location/MyFolder/MyCategory path.
5. Click Create.
  The new generator is added in the newly created category and is displayed in the Catalog panel of the data definition.

Results

You have created a custom generator using an existing generator from a Data definition. Also, you have learned to create a new category and save the custom generator under the category.

What to do next

You can save and publish the Data definition to the Git repository so that other members of the project can use the Data definition. See Publishing changes in an Edit branch.