Home
Test Author Guide
This guide describes how to create test assets in HCL OneTest™ Server and publish test assets to the Git repository that you have configured. This guide is intended for testers and test managers.
Generation of test data
To test an application, you use data that is passed to get real-time results. Since creating test data manually is time-consuming, you can use HCL® OneTest™ Data, an automated tool to generate random test data. You can generate the test data in various file formats.
Test data generation from structured schemas
When you want to test your application by using randomly generated test data, then you must generate the test data from the structured schemas.
Generated test data in JDBC-supported databases
When you want the generated test data in any Java Database Connectivity (JDBC) supported database, you can generate the test data by using HCL® OneTest™ Data. Subsequently, HCL OneTest Data inserts the generated test data directly in the configured JDBC-supported database.
Establishing a JDBC connection
You must establish a connection between HCL® OneTest™ Data and the JDBC supported database to generate the schema and to write the generated test data in the database.

Test Author Guide
This guide describes how to create test assets in HCL OneTest™ Server and publish test assets to the Git repository that you have configured. This guide is intended for testers and test managers.
- Datasets overview
  A dataset provides tests with variable data during a run. The test that uses a dataset at run time replaces a value in the recorded test with variable test data that is stored in the dataset.
- Generation of test data
  To test an application, you use data that is passed to get real-time results. Since creating test data manually is time-consuming, you can use HCL® OneTest™ Data, an automated tool to generate random test data. You can generate the test data in various file formats.
  - Schema fabrication
    A schema is a graphical structure to represent different types of data. You can fabricate a schema for the generation of test data.
  - Schema design overview
    When you compose a schema by using HCL® OneTest™ Data you must define the types of the schema. You can also modify the types of the schema when you import any schema from local file system or use the schema generated by using any external resource.
  - Test data generation from structured schemas
    When you want to test your application by using randomly generated test data, then you must generate the test data from the structured schemas.
    - Generated test data in JDBC-supported databases
      When you want the generated test data in any Java Database Connectivity (JDBC) supported database, you can generate the test data by using HCL® OneTest™ Data. Subsequently, HCL OneTest Data inserts the generated test data directly in the configured JDBC-supported database.
      - Creating a sample schema in a database
        To generate a schema in HCL® OneTest™ Data, you must create a schema with a table in the database.
      - Establishing a JDBC connection
        You must establish a connection between HCL® OneTest™ Data and the JDBC supported database to generate the schema and to write the generated test data in the database.
      - Generating a schema in HCL OneTest Data
        After you establish the connection between HCL® OneTest™ Data and the JDBC-supported database, you can generate a schema in HCL OneTest Data from the configured database.
      - Inserting the generated test data in a database
        After you generate the schema from the configured database in HCL® OneTest™ Data, you can directly insert the generated test data into the database.
    - Generated test data for SAP IDoc or DXOB
      When you want to generate the test data for an SAP Intermediate Document (IDoc) or Data Transfer Object (DXOB) file, you can generate a schema in HCL® OneTest™ Data by using the structured schema of the SAP IDoc or DXOB file. You can then generate the test data by using the generated schema in HCL OneTest Data.
    - Generated test data for SAP BAPI
      When you want to generate test data for SAP Business Application Programming Interface (BAPI), you can generate a schema in HCL® OneTest™ Data based on structured schema of SAP BAPI function modules. You can then generate the test data by using the generated schema in HCL OneTest Data.
    - Generated test data in MongoDB
      When you use MongoDB as a database in your application testing environment and you want the generated test data in MongoDB, then you can generate the test data by using HCL® OneTest™ Data. Subsequently, HCL OneTest Data inserts the generated test data directly in MongoDB.
    - Generated test data for an Excel file
      When you use Microsoft Excel as a database in your application testing environment and you want to use the structure of an Excel file to generate test data, then you can generate the test data for the selected Excel file by using HCL® OneTest™ Data.
    - Generating test data
      When you have a defined and structured schema for the entire data, you can generate test data to perform application testing.
    - Generating the test data by using multiple schemas
      You can generate the test data either by using multiple JDBC-supported or non-JDBC schemas.
    - Generating DDL statements for schemas
      When you want to know the Structured Query Language (SQL) statements to create a table from non-JDBC schemas that you created in HCL® OneTest™ Data, you can generate the Data Definition Language (DDL) statements for those selected schemas.
  - Status of generated test data
    You can view the status of all the test data generated jobs and Data Definition Language (DDL) statements generated jobs performed in your project, on the Jobs page.

Establishing a JDBC connection with HCL OneTest Data

You must establish a connection between HCL® OneTest™ Data and the JDBC supported database to generate the schema and to write the generated test data in the database.

Before you begin

You must have created a sample schema in the database. See Creating a sample schema in a database.

Procedure

Log in to HCL OneTest™ Server and open the team space that contains your project.
Open your project.
The Overview page is displayed.
Click Author > Data Fabrication.
The Data Fabrication page is displayed.
Click New from the Connections tab to create a new connection.
Select JDBC as a connection type and click Next.
Enter the following properties of the connection in the Properties dialog box.
1. Enter the URL of the database.
  You must provide the URL in the following format:jdbc:<DatabaseType>://<HostName/IPAddress>:<PortNumber>/<CustomSettings>
  Note: You must provide the database name in <CustomSettings> for establishing connection with IBM DB2 database.
  For example,
  - MySQL Server - jdbc:mysql://10.0.2.15:8081
  - Microsoft SQL Server - jdbc:sqlserver://10.134.59.16:1433
  - IBM DB2 - jdbc:db2://10.134.59.16:50000/testdb
2. Enter the name and password to access the database.
Click Test to verify whether the connection is established successfully.
Note: If the connection fails to establish, it can be because of one of the following reasons:
- Mismatch in the version of the drivers.
- Unreachable database.
- Missing database.
- Unsuccessful copying of the connector jar file.
You can run the following command to check the logs of HIP Server to get more information about the reason of failure:

kubectl logs {my-ots}-hip-server-0 -n test-system

Results

You have successfully established the connection between HCL® OneTest™ Data and the database.

What to do next

You must provide a name for the connection, and then generate a schema. See Generating a schema in HCL OneTest Data.