Home
Test Author Guide
This guide describes how to create and edit test assets in HCL OneTest™ Server, 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.
Datasets overview
A dataset contains variable data that are used by a test at test run time. The variable data is contained in rows for a specific parameter that is contained in columns. You can decide whether you want to use the dataset associated with the test to be used at run time or override that associated dataset with another dataset at run time.
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.
Decrypting a dataset column
To view the content of an encrypted dataset, you can decrypt the dataset column. Removing encryption from a dataset revokes the protection offered to the test data.

Test Author Guide
This guide describes how to create and edit test assets in HCL OneTest™ Server, 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 asset or resource in HCL OneTest™ Server, 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.
- Test authoring
  You can use HCL OneTest™ Server to author tests instead of creating the tests by using the desktop products.
- 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 OneTest™ Server to fabricate test data. You can also create or edit datasets that pass variable data to tests at test run time.
- Datasets overview
  A dataset contains variable data that are used by a test at test run time. The variable data is contained in rows for a specific parameter that is contained in columns. You can decide whether you want to use the dataset associated with the test to be used at run time or override that associated dataset with another dataset at run time.
  - Creating a dataset
    You can create datasets in HCL OneTest™ Server 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 OneTest™ Server.
  - Creating a dataset by using a Data definition
    When you created a Data definition in HCL OneTest™ Server to fabricate test data, you can create a dataset by using the Data definition.
  - 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. 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, 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 OneTest™ Server, 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 include datasets, you can view the contents of a dataset from HCL OneTest™ Server. 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 OneTest™ Server.
  - Changing the classification
    To move the encrypted dataset from one classification to another, 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 OneTest™ Server 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.

Decrypting a dataset column

To view the content of an encrypted dataset, you can decrypt the dataset column. Removing encryption from a dataset revokes the protection offered to the test data.

Before you begin

You must have created at least one dataset and encrypted the dataset with an encryption key. See Creating a dataset and Encrypting a dataset column.

Procedure

Log in to HCL OneTest™ Server.

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 are displayed.
Select the branch that contains your project with the datasets that you want to edit.

The projects in the selected branch are displayed in the Data navigator. The datasets are listed under the folder you created to contain the dataset within a logical folder named Datasets.
Click the dataset in the data navigator.

The dataset opens in the right pane.
Click Edit.
Select your action to either select an existing Edit branch or create an Edit branch:
- Perform the following steps to select the edit branch:
  1. Select an Edit branch from the Select branch list if Edit branches already exist in the selected branch of the repository.
  2. Click Ok.
  You selected an existing Edit branch.
- Perform the following steps to create the edit branch:
  1. Select Create new branch.
  2. Enter a name for the edit branch.
  3. Click Save.
  You created an Edit branch.
Right-click encrypted cells that display the contents with asterisks, and then select Decrypt column data.
The Decrypt Column window is displayed.
Enter the encryption key that you used to encrypt the data in the column in the Encryption Key field.
Click Decrypt Column.
Asterisks are replaced with the actual data in the decrypted column.
Click the Save icon to save the changes to the dataset.

Results

The encryption is removed from the selected column in the dataset. When you run a test that uses a dataset that contains decrypted data, the variable data is substituted for the original data in the recorded test without prompting for the encryption.

What to do next

You can publish the dataset to the Git repository so that other members of the project can use the dataset by clicking the Publish icon publish_icon

publish_icon

. See Publishing changes in datasets.