Home
Test Author Guide
This guide describes how to create and edit test assets in HCL DevOps Test Hub (Test Hub), and then publish test assets to the remote Git repository that you have configured in your project. This guide is intended for testers and test managers.
Data fabrication
Test data is the core component of any application testing. It is very time-consuming to create test data manually. You can use the data fabrication feature in HCL DevOps Test Hub (Test Hub) to create realistic datasets for comprehensive testing scenarios. The feature provides data fabrication capabilities that can help you to generate synthetic data quickly and efficiently without the risk of data leaks or privacy issues.
Management of custom categories
HCL DevOps Test Hub (Test Hub) provides flexibility to create and delete custom categories in the Catalog page. The Catalog page displays both the basic and custom categories of generators in a project.
Creating a new custom category
You can create custom categories in addition to the existing Basic category in the HCL DevOps Test Hub (Test Hub) catalog. You can save the custom generators under various custom categories with unique names.

Test Author Guide
This guide describes how to create and edit test assets in HCL DevOps Test Hub (Test Hub), and then publish test assets to the remote Git repository that you have configured in your project. This guide is intended for testers and test managers.
- Edit branch overview
  When you want to create or modify a test resource in HCL DevOps Test Hub (Test Hub), you must use an Edit branch. An Edit branch is a temporary branch of the branch in the project repository into which you want to add the created resource or edited resource.
- Data overview
  When you want to create realistic test scenarios that can simulate real-world or practical situations, you can use the data fabrication feature in HCL DevOps Test Hub (Test Hub) to fabricate test data. You can also create or edit datasets that pass variable data to tests at test run time.
- Prerequisites for working with Datasets and Data definition
  You can find information about the tasks that you need to perform before you work with datasets and Data definitions in HCL DevOps Test Hub (Test Hub).
- Working with Datasets on DevOps Test Hub
  You can find information about creating datasets in HCL DevOps Test Hub (Test Hub), applying a dataset classification, editing datasets, and managing datasets that are in your project repository.
- Data fabrication
  Test data is the core component of any application testing. It is very time-consuming to create test data manually. You can use the data fabrication feature in HCL DevOps Test Hub (Test Hub) to create realistic datasets for comprehensive testing scenarios. The feature provides data fabrication capabilities that can help you to generate synthetic data quickly and efficiently without the risk of data leaks or privacy issues.
  - Overview of data fabrication
    You can find information about an overview of the data fabrication feature that is available in HCL DevOps Test Hub (Test Hub).
  - Creating an empty Data definition
    You can create an empty Data definition in HCL DevOps Test Hub (Test Hub) as the first step to create a Data definition. After you save the empty Data definition to a folder in your project repository, you can edit the Data definition to add the different generators.
  - Creating a Data definition by importing fields from a CSV file
    When you want to create a Data definition in HCL DevOps Test Hub (Test Hub) with specific fields for the test data, you can import a CSV file that defines the specific fields. After you import fields to the Data definition, you can edit the Data definition and add generators for the specific fields before you generate the test data.
  - Creating a Data definition by importing fields from a dataset
    When you want to create a Data definition in HCL DevOps Test Hub (Test Hub) with specific fields for the test data, you can import the fields from a dataset. After you import fields to the Data definition, you can edit the Data definition and add generators for the specific fields before you generate the test data.
  - Creating a Data definition by importing fields from a database query
    You can create Data definition to generate a random test data that is required to run a test in HCL DevOps Test Hub (Test Hub) using the specific database fields.
  - Saving a Data definition by adding basic generators with their default settings
    After you create a Data definition in HCL DevOps Test Hub (Test Hub), you must add the basic generators with their default settings and save the Data definition before you can generate test data.
  - Saving a Data definition by adding basic generators with their modified settings
    After you create an empty Data definition in HCL DevOps Test Hub (Test Hub), you must add the basic generators with their modified settings, and save the Data definition before you can generate test data.
  - Modifying a Data definition
    After you create and publish a Data definition in HCL DevOps Test Hub (Test Hub), you can modify the fields or the configuration of the generators in an existing Data definition when you want to change the structure of the test data.
  - Publishing changes in an Edit branch
    After you create or modify a Data definition, a generator, or a generator category in a project in HCL DevOps Test Hub (Test Hub), you can publish all the changes that are in an Edit branch to the branch in the project repository. After which, other members in the project can view and use the test resources. The Edit branch automatically disappears from the Branch list of the Data page and the changes made to the project are merged into the previously selected branch name.
  - Viewing a Data definition and its details
    You can view the contents of a Data definition on the Data page in HCL DevOps Test Hub (Test Hub).
  - Deleting Data definitions
    You can delete Data definitions to remove them when the data definitions are outdated or no longer relevant to the current project. Additionally, when Data definitions contain errors or inaccuracies that can lead to misleading or incorrect fabricated data, then you might want to remove them. This ensures that the project remains clutter-free, optimizes the performance of HCL DevOps Test Hub (Test Hub), and reduces storage requirements.
  - Basic generators
    You can use the built-in basic generators in Data definitions with or without modifying the default configurations of the generators.
  - Generation of test data
    You can use the data fabrication feature in HCL DevOps Test Hub (Test Hub) to create realistic datasets for comprehensive testing scenarios. You can generate the test data as the Comma-Separated Values (CSV) files that is saved in your system. You can then use these files to replace any existing datasets in a test during the run time. If a dataset is already associated with a test, you can replace the dataset at runtime with the dataset that is created from the data fabrication feature of Test Hub. This allows you to integrate the generated test data into your test execution process, and you can ensure that your tests are performed with the secure and realistic data.
  - Management of custom generators
    HCL DevOps Test Hub (Test Hub) provides flexibility to create, modify, and delete custom generators. You can access and modify custom generators to suit your specific data requirements in the Catalog page.
  - Management of custom categories
    HCL DevOps Test Hub (Test Hub) provides flexibility to create and delete custom categories in the Catalog page. The Catalog page displays both the basic and custom categories of generators in a project.
    - Creating a new custom category
      You can create custom categories in addition to the existing Basic category in the HCL DevOps Test Hub (Test Hub) catalog. You can save the custom generators under various custom categories with unique names.
    - Deleting custom categories
      You can delete custom categories to remove them when custom categories are outdated or no longer relevant to the current project. Additionally, when custom categories contain inaccuracies that can lead to misleading or incorrect fabricated data, then you might need to remove them. This ensures that the project remains clutter-free, optimizes the performance of HCL DevOps Test Hub (Test Hub), and reduces storage requirements.

Creating a new custom category

You can create custom categories in addition to the existing Basic category in the HCL DevOps Test Hub (Test Hub) catalog. You can save the custom generators under various custom categories with unique names.

Before you begin

You must be a member of the project with the Owner or Tester role.

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 > Catalog.
The Catalog page is displayed.
Select the branch where you want to store the custom category from the Branch list.
Click the icon in the Catalog page, and then click Add new category.
Based on the selected Branch, the following dialog is displayed:
- Edit Branch: If you selected a branch other than the Edit branch.
- Add new category: If you selected the Edit branch.

Perform one of the following actions in the Edit branch dialog, if you selected a branch other than the Edit branch:


Action	Steps	Result
Select an Edit branch	Select an Edit branch from the Select branch list if the Edit branch already exists. Click Ok.	The Add new category dialog is displayed.
Create an Edit branch	Select Create new branch. Enter a name for the Edit branch. Click Save.	The Add new category dialog is displayed.

Perform the following steps in the Add new category dialog:
1. Enter a unique name in the Category name field.
2. Select a color from the available range of colors so that you can identify the new category easily.
3. 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.
4. Click Create.
The new category is added in the Catalog page.

Results

You created a custom category in the Catalog page.

What to do next

You can perform the following tasks:

Add custom generators to the new category. See Creating a custom generator.
Publish the changes to the Git repository so that other members of the project can use the new custom category. See Publishing changes in an Edit branch.