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.
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.
Dataset encryption
Encrypted datasets are useful when you want to run tests that contain confidential information such as a set of passwords or account numbers.

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.
  - Creating a dataset
    You can create datasets in HCL DevOps Test Hub (Test Hub) to replace the values of existing dataset with the values of new dataset during a test or schedule run.
  - Creating a dataset by using a CSV file
    When you use variable data that is contained in a CSV file, you can import the data from the CSV file and create a dataset in HCL DevOps Test Hub (Test Hub).
  - Creating a dataset by using a Data definition
    When you created a Data definition in HCL DevOps Test Hub (Test Hub) to fabricate test data, you can create a dataset by using the Data definition.
  - Creating a dataset by using a database query
    When you use variable data that is contained in a database, you can create a database query to import the required data from a database and use the data that is present in the database query to create a dataset in HCL DevOps Test Hub (Test Hub).
  - Editing a dataset
    You can add, modify, remove, import, or export data from a dataset.
  - Dataset encryption
    Encrypted datasets are useful when you want to run tests that contain confidential information such as a set of passwords or account numbers.
    - Encrypting a dataset column
      To secure test data, you must encrypt datasets in HCL DevOps Test Hub (Test Hub). You can encrypt data in the columns of a dataset by using an encryption key. When you run a test that utilizes a dataset with encrypted variables, you must enter the encryption key for the encrypted column that the test uses.
    - Decrypting a dataset column
      To view the content of an encrypted dataset in HCL DevOps Test Hub (Test Hub), you can decrypt the dataset column. Removing encryption from a dataset revokes the protection offered to the test data.
  - Publishing changes in datasets
    After you create, edit, or encrypt datasets in HCL DevOps Test Hub (Test Hub), you can publish all changes made to a dataset to a branch in the project. After you publish the dataset, other members in the project can use your dataset in their test run, if required. The Edit branch automatically disappears from the Branch list and changes made to the datasets are merged into the selected branch of the project repository.
  - Viewing a dataset
    When test assets includes datasets, you can view the contents of a dataset from HCL DevOps Test Hub (Test Hub). The datasets residing in the Git repository are listed in the Datasets page.
  - Deleting a dataset
    You can delete the dataset when it is not required in your test environment.
  - Viewing an encrypted dataset
    You can use the Dataset page to view the contents of an encrypted dataset from HCL DevOps Test Hub (Test Hub).
  - Changing classification for an encrypted dataset
    To move the encrypted dataset from one classification to another dataset in HCL DevOps Test Hub (Test Hub), you can change the classification for an encrypted dataset.
  - Managing an encrypted dataset
    You can use encrypted datasets to limit access to confidential information such as account number or passwords. You can arrange data by an appropriate category so that project members can use datasets more effectively in certain tests and protect them.
- 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.

Dataset encryption

Encrypted datasets are useful when you want to run tests that contain confidential information such as a set of passwords or account numbers.

When you run a test in HCL DevOps Test Hub (Test Hub) that uses an encrypted dataset, then you must provide an encryption key for decrypting the encrypted data in columns so that the data can be used in the test. If the test uses data from the multiple encrypted dataset columns, you must enter the same encryption key for every encrypted dataset column that the test uses.

When you run the test that uses the dataset with the encrypted column, the value of the column is decrypted at a run time. The data in the column is sent as a clear-text string in requests to the server. The actual values of the encrypted dataset variables are not displayed in the test log. The test log displays asterisks for the encrypted dataset variables.

You can use only one encryption key to encrypt data in the columns in any dataset.

You can set the dataset classification (encrypted password) for a dataset. The dataset classification that you set is applied for the dataset if it is saved in different branches of the project repository and you need not set a password for the dataset in each branch. If you want to use different passwords, then you can create a different dataset by cloning the dataset that you want.

Important:

The encryption keys that you use to encrypt data in a dataset are not stored on the server nor can be retrieved from the server. Therefore, you must remember to store the encryption keys in a secure location. You must use the same encryption keys to perform the following operations:

View the encrypted values
Decrypt data
Enable the use of the encrypted dataset during test runs