Home
Getting Started
This guide provides an overview and describes the tasks to get you started with HCL OneTest™ API.
Testing methodology
By following four basic guidelines, you can incorporate HCL OneTest™ API into your testing methodology. These guidelines drive efficient and expedient integration testing, and they can be applied to your testing process and infrastructure requirements.
Project structure
When an HCL OneTest™ API project is created for the first time, the project folder structure is created on a disk.
Implementing tests
As the number of tests grows, it is important to be able to differentiate tests. If you can deduce information from the test name, you avoid wasting time while searching for a specific test.
Running tests and test suites
You might decide to run tests individually or to create a regression suite and then add your tests to the suite.

Getting Started
This guide provides an overview and describes the tasks to get you started with HCL OneTest™ API.
- HCL OneTest™ API overview
  You can use HCL OneTest™ API to create, modify, and run service tests.
- Testing methodology
  By following four basic guidelines, you can incorporate HCL OneTest™ API into your testing methodology. These guidelines drive efficient and expedient integration testing, and they can be applied to your testing process and infrastructure requirements.
  - Test approach
    The HCL OneTest™ Studio product suite fits easily into a V-Model approach. The classic V-Model demonstrates each phase in predevelopment and its associated phase in test planning. For example, when the system design is delivered, begin planning for system testing. Testing activities such as design, analysis, planning and execution must happen throughout the entire project life cycle.
  - Test phases
    Apart from being used for driving early test plans, HCL OneTest™ API can be used to shift testing earlier in the software development lifecycle (SDLC) than is traditionally possible with standard test tools that test at the UI level. Soon after you have a local build, you can use HCL OneTest API to do service unit testing.
  - Building tests
    HCL OneTest™ API separates the task of learning about the system from the tasks of creating test resources, designing (building models), creating and recording test assets, and running tests.
  - Project structure
    When an HCL OneTest™ API project is created for the first time, the project folder structure is created on a disk.
    - Folder structures
      As the number of artifacts grows, a project might start to look disorganized and tests and stubs might become difficult to locate. Adding meaningful logical folder structures means that test artifacts can be organized neatly and found quickly.
    - Architecture school
      Architecture School is the default perspective of HCL OneTest™ API. In this perspective, you build the system to be tested in a simple, graphical fashion, and define the logical and physical system components and their relationships to one another.
    - Implementing tests
      As the number of tests grows, it is important to be able to differentiate tests. If you can deduce information from the test name, you avoid wasting time while searching for a specific test.
      - Test data
        Where possible, put test data sets in the project's directory, either under each operation or in a separate data sets folder. This helps with portability and maintenance of your project.
      - Creating test templates and test suites
        You can implement several tests with similar logic. When creating tests, define a template if a test is repeatedly created. Test suites are used mainly to construct reusable, packaged regression tests that can be run across multiple environments, or repeatedly within the same environment.
      - Running tests and test suites
        You might decide to run tests individually or to create a regression suite and then add your tests to the suite.
      - Implementing stubs
        When you implement stubs, you want to consider a few points such as naming conventions and folder structure.
      - Stub performance
        Performance usually matters for stubs because they receive requests with a high level of frequency.
- Service-oriented architecture (SOA) testing
  A SOA consists of business processes that are implemented by linking individual services. The linking can be done programmatically or with tools based on Business Process Execution Language (BPEL). SOA testing can be challenging because there is no GUI; the focus is on testing interfaces and services.
- Getting started with testing
  You can start using HCL OneTest™ API by completing the preliminary tasks such as creating and running a test, creating and running a stub, recording an HTTP proxy, and running a stub in a Docker container.
- HCL® Quality Server overview
  HCL OneTest™ Virtualization stubs designed in HCL OneTest API are published to HCL® Quality Server, which holds them in a repository.
- HCL OneTest™ API accessibility features
  Users who have a physical disability, such as limited vision, can review the available accessibility features to use HCL OneTest™ API.

Running tests and test suites

You might decide to run tests individually or to create a regression suite and then add your tests to the suite.

Consider the following points:

Always check your environment setting before you run a test or test suite.
Include Log actions in your tests to enable you to debug console output.

If you prefer to run your regression pack as part of a continuous integration (CI) build process, use Apache Ant scripts to run your tests. An example of this is the use of Jenkins.

Take note of the following tips when working with Apache Ant scripts:

Generate Ant scripts for each test regression pack suite you want to run during CI and save them in a folder in the project's directory.
In the Ant scripts, change the hardcoded environment name to a variable that can be substituted at run time. This enables you to run the script in any environment you choose.