Home
Tester Guide
This guide describes the tasks that you can perform for testing various domains, technologies, and applications. To enable testing, you must configure and enable the environment for testing.
API Tester Guide
This guide describes the tasks that you can perform for testing various domains, technologies, and applications. To enable testing, you must configure and enable the environment for testing. This guide is intended for API testers.
Working in non-GUI mode
You can use the tools and executable files that are provided along with the product software. You can use these tools to perform different test actions in a non-GUI mode.
Managing environments
Locking a HCL® Quality Server environment prevents other users from changing the state of that environment, for example, starting or stopping stubs.
Creating an environment by using an Ant task
You can create an environment by using the HCL® Quality Server Ant task.

Tester Guide
This guide describes the tasks that you can perform for testing various domains, technologies, and applications. To enable testing, you must configure and enable the environment for testing.
- API Tester Guide
  This guide describes the tasks that you can perform for testing various domains, technologies, and applications. To enable testing, you must configure and enable the environment for testing. This guide is intended for API testers.
  - API Testing
    You can use find information about the tasks that you can perform for testing various domains, technologies, or applications.
  - Extending HCL OneTest™ API functionality by using custom functions
    You can add more calculations and operations to tests by using the HCL OneTest™ API custom function class. HCL OneTest API custom function is a Java™ class that extends the com.ghc.ghTester.expressions function.
  - Working in non-GUI mode
    You can use the tools and executable files that are provided along with the product software. You can use these tools to perform different test actions in a non-GUI mode.
    - Command-line interfaces
      HCL OneTest™ API command-line client is available in HCL OneTest API 8.0.1 or later.
    - Ant tasks
      You can use the supported Ant tasks that is supplied with HCL® Quality Server to create, update, or manage the environment, scenarios, and stubs.
    - REST services
      Representational state transfer (REST) is a simple stateless architecture that generally runs over HTTP. When used in conjunction with HCL® Quality Server, HTTP methods (such as GET and POST) are mapped to actions on domains, environments, scenarios, stubs and other resource types.
    - Running tests
      Use HCL OneTest™ API to run tests with command-line and Ant APIs.
    - Managing test results
      Use HCL® Quality Server to manage test results with command-line APIs.
    - Managing domains
      You can create, list, update, and delete domains with the HCL® Quality Server REST API.
    - Managing environments
      Locking a HCL® Quality Server environment prevents other users from changing the state of that environment, for example, starting or stopping stubs.
      - Locking an environment by using the command line
        You can lock an environment by using the HCL OneTest™ API command line. This option is useful in situations where Ant is not available.
      - Unlocking an environment by using the command line
        You can unlock an environment by using the HCL OneTest™ API command line. This option is useful in situations where Ant is not available.
      - Deleting an environment by using the command line
        You can delete an environment and its associated artifacts by using the HCL OneTest™ API command line. This option is useful in situations where Ant is not available.
      - Creating an environment by using an Ant task
        You can create an environment by using the HCL® Quality Server Ant task.
      - Deleting an environment by using an Ant task
        You can delete an environment and its associated artifacts by using the HCL® Quality Server Ant tasks.
      - Updating an environment by using an Ant task
        You can update values of the attributes of an environment by using the HCL® Quality Server Ant task.
      - Locking an environment by using an Ant task
        You can lock an environment by using the HCL® Quality Server Ant tasks.
      - Unlocking an environment by using an Ant task
        You can unlock an environment by using the HCL® Quality Server Ant tasks.
      - REST services
        Representational state transfer (REST) is a simple stateless architecture that generally runs over HTTP. When used in conjunction with HCL® Quality Server, HTTP methods (such as GET and POST) are mapped to actions on domains, environments, scenarios, stubs and other resource types.
    - Managing scenarios
      Use HCL® Quality Server to manage scenarios with command-line, Ant, and REST APIs.
    - Managing stubs
      You can manage stubs by using the command-line, Ant, and REST APIs.
- Tester Guide - Service Virtualization
  This guide describes the tasks that you can perform for using virtual services or stubs to simulate parts of an environment if the real services are not yet available or because they are difficult or expensive to use. This guide is intended for API Testers.

Creating an environment by using an Ant task

You can create an environment by using the HCL® Quality Server Ant task.

Here is an example syntax:

<taskdef name="createEnvironment" classname="com.ghc.ghTester.ant.CreateEnvironment" classpathref="tasklib" />
<createEnvironment domain="<Domain name>" baseEnvironment="<Environment name>" description="<description>" 
serverUrl="https://Hostname or IP address:5443/RTCP/" nameProperty="<Property to set with the environment>" 
securityToken="<Security token>" />

The following table lists the attributes that you can use with the createEnvironment Ant task for creating an environment.

Table 1. List of available attributes
Attribute	Description	Required
`baseEnvironment`	The name of the environment to be used as the base of the created environment.	Yes
`domain`	Domain name	Yes
`nameProperty`	The property to set for the created environment. The following properties can be set: haltOnFailure When set as `true`, it fails the ant script if the environment is not created. failureProperty Property to set as `true` if the environment is not created.	No
`securityToken`	The value of the security token to use for authentication with HCL® Quality Server when domain security is enabled. For more information, see Domain level security.	No
`serverUrl`	URL of the HCL® Quality Server	Yes

Note: All environment creation events are recorded in the HCL® Quality Server Audit log. (For information about this log, refer to Administration of HCL Quality Server.)

Error codes

For details of any error codes, see Exit codes for Command-line client and Ant client.