Welcome
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 management
Effective data management is at the core of robust application testing. In HCL DevOps Test Hub (Test Hub), you can manage test data by using the Data tab, which provides a centralized workspace for handling various types of data. Whether you work with fabricated data, retrieve information from databases, or define structured schemas, this interface supports both creating new data and reusing existing assets across your testing requirements.
Prerequisites for working with datasets and data definitions
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).
Management of database connections
You can add a database connection to a project and import the data from an external database in HCL DevOps Test Hub (Test Hub).
Adding a database connection to a security group
You can add the database connection to a security group to grant access to the security group for other project members in HCL DevOps Test Hub (Test Hub). After the access is provided, they can use the database connection to create the database query and import the data from the database.

Release Notes
This document includes information about the new features introduced, features deprecated or removed, defects fixed, and known issues identified in this version of HCL DevOps Test Hub (Test Hub). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System Requirements
This document includes information about hardware and software requirements for HCL DevOps Test Hub (Test Hub).
Getting Started Guide
This guide provides an introduction to HCL DevOps Test Hub (Test Hub) covering key features, task flows, and setup instructions. You can get started with installation, integration, user access management, and core functionalities like test data creation, test asset management, and reporting. This guide is intended for new users.
Tutorials
Learn how to perform frequently used tasks, including creating and managing Web UI tests and viewing test results through functional reports.
Administrator Guide
This guide describes how to install the HCL DevOps Test Hub (Test Hub) software.
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 created from the selected branch in the repository configured within the project, where you can save the created or edited resource.
- Test Editor overview
  You can use the Test Editor tab to create and manage test assets such as applications, Web UI tests, test suites, and environments in HCL DevOps Test Hub (Test Hub).
- Application management
  When you want to create and manage Web UI tests in HCL DevOps Test Hub (Test Hub), you must first create an application within the project.
- Web UI test management
  You can test your web applications by recording Web UI tests in HCL DevOps Test Hub (Test Hub). Test Hub supports industry-standard browsers such as Google Chrome, Microsoft Edge, and Mozilla Firefox to record and play back Web UI tests. After the playback, you can evaluate the test results.
- Test suite management
  A suite is a collection of the tests and other suites. You can combine the multiple tests and suites into a single workflow and organize them into a suite.
- Test variables
  A test variable is a user-defined, name-value pair that stores and refers to information throughout a test. You can assign the value of a variable to a test element or assign the value of a UI object property to a test variable.
- Test environments
  You can define custom environments to manage sets of variables such as application URLs and user credentials, and to configure profile overrides. When you run a test, the variables and override rules defined in the environment dynamically replace the values within your test script. You can easily change testing targets without modifying your test script by using environments because the environment-level configurations take precedence over the default values defined in the script.
- Catalog management
  You can use the data catalog in HCL DevOps Test Hub (Test Hub) to browse and manage data generators used in test data creation. The catalog section provides access to built-in generators, allows you to create custom generators tailored to specific needs, and group them using custom categories.
- Data management
  Effective data management is at the core of robust application testing. In HCL DevOps Test Hub (Test Hub), you can manage test data by using the Data tab, which provides a centralized workspace for handling various types of data. Whether you work with fabricated data, retrieve information from databases, or define structured schemas, this interface supports both creating new data and reusing existing assets across your testing requirements.
  - Data navigator panel
    The home page of Data features a navigation panel called the data navigator panel, which serves as a central hub for managing and organizing data definitions, datasets, database queries, and schemas across multiple folders within your project.
  - Prerequisites for working with datasets and data definitions
    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).
    - Management of security groups
      You can find information about creating, editing, deleting, and granting access to a security group in HCL DevOps Test Hub (Test Hub).
    - Management of database connections
      You can add a database connection to a project and import the data from an external database in HCL DevOps Test Hub (Test Hub).
      - Adding a database connection
        You can add a database connection to your project in HCL DevOps Test Hub (Test Hub) to import the data from an external database and create the test assets. You can restrict the project members from using this database connection by adding it to a security group and providing permission only to the required members.
      - Adding a database connection to a security group
        You can add the database connection to a security group to grant access to the security group for other project members in HCL DevOps Test Hub (Test Hub). After the access is provided, they can use the database connection to create the database query and import the data from the database.
      - Removing a database connection from a security group
        You can remove a database connection from a security group when you are no longer required to provide access to other members of your project.
      - Editing a database connection
        You can edit the database connection, when you want to change the database details that you added earlier or if you want to update the SSL certificate file.
      - Duplicating a database connection
        When you want create a similar database connection with different user credentials, to create the similar database connection and restrict or unrestricted it, or to create a similar database connection by encrypting the data exchanged between HCL DevOps Test Hub (Test Hub) and database, you can create a new database connection using an existing database connection.
      - Deleting a database connection
        You can delete the database connection from a project when it is no longer required.
    - Management of database query
      You can find information about creating, editing, duplicating, and deleting the database query in HCL DevOps Test Hub (Test Hub).
  - Management of datasets
    You can find information about creating datasets in HCL DevOps Test Hub (Test Hub), applying a dataset security group, editing datasets, and managing datasets that are in your project repository.
  - Management of data definition
    You can find information about creating, editing, and managing data definitions in HCL DevOps Test Hub (Test Hub), to support realistic and reusable test data generation.
  - Management of schemas
    A schema, also known as a database schema, defines how data is structured, organized, and managed in a database management system (DBMS). It outlines the format, storage, processing, security, and data access across various structural schema elements such as tables, views, and logical constraints.
  - Publishing changes in data definitions, datasets, or schemas
    After creating or modifying a data definition, dataset, or schema in HCL DevOps Test Hub (Test Hub), you can publish changes from an Edit branch to the source branch in the project repository. After you publish the changes, other members of the project can view and work with the updated datasets.
  - Generating fabricated test data
    You can generate fabricated test data in HCL DevOps Test Hub (Test Hub) to support a wide range of test scenarios. The generated data is saved as a CSV file on your system and can be used to override existing datasets during test execution.
- Publishing all changes in an Edit branch
  After you create or modify any data or test assets in an Edit branch of a project in HCL DevOps Test Hub (Test Hub), you can publish all the changes that are in an Edit branch to the source branch in the project repository. After publishing, other members in the project can view and use the resources.
Test Execution Specialist Guide
This guide describes tasks that you must complete before you can configure and run tests in HCL DevOps Test Hub (Test Hub). You can find information about configuring runs for the different test types that are supported. You can also find information about other tasks that you can perform on the Resource Monitoring Service, Virtualization, and Integrations with third-party applications. This guide is intended for testers or test execution specialists.
Test Manager Guide
This guide describes how to manage and track your overall test effort. This guide is intended for test managers.
Troubleshooting
This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with HCL DevOps Test Hub (Test Hub).
Unable to publish test assets to a Control repository
When you attempt to publish test assets from HCL DevOps Test Hub (Test Hub) to a Control repository, the publish operation might fail with the following message: Remote rejected; pre-receive hook declined.
All Guides (PDF)
You can find the link to view or download the content of the release notes, system requirements, and persona guides of HCL DevOps Test Hub (Test Hub) as a PDF file.
Security Considerations
This document describes the actions that you can take to ensure that your installation is secure, customize your security settings, and set up user access controls in HCL DevOps Test Hub (Test Hub).
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Adding a database connection to a security group

You can add the database connection to a security group to grant access to the security group for other project members in HCL DevOps Test Hub (Test Hub). After the access is provided, they can use the database connection to create the database query and import the data from the database.

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.
Added at least one database connection and restricted the access to other members of the project. See Adding a database connection
Added the remote Git repository that contains the test resources to the project. See Adding repositories to a server project.
Created at least one security group. See Creating a security group.

Procedure

Log in to Test Hub.
The Projects page of the initial team space is displayed.
Click My projects > project_name to open the project that contains the test assets.

The Overview page of the project is displayed.
Click Manage > Security.
The Security page is displayed.
Click a security group for which you want to add the database connection in the list under Security Group.
Click the Add Connection icon to select the database that you want to add to the security group.
The Add Connection dialog is displayed.
Click the Database Connection field to view the available database connection in the project.
Identify and select the database connection that you want to add to the security group.
Enter the password that you use to connect to the database in the Password field.

Tip:
You can click the view icon to view the entered password and ensure that you entered the correct password.
Click Add.
The database connection that is added to the security group is displayed.

Results

You have added a database connection to the security group.

What to do next

You can create a database query by using the database connection that you added to your project. See Creating a database query.