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.
Implementing stubs
When you implement stubs, you want to consider a few points such as naming conventions and folder structure.

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.

Implementing stubs

When you implement stubs, you want to consider a few points such as naming conventions and folder structure.

As the number of stubs grows, it is important to be able to differentiate between stubs. If you can deduce information from the stub name, you avoid wasting time while searching for a specific stub.

Consider the following points:

Use good naming conventions to name your stubs.
Create logical folder structures to store your stubs.
Use the Business View to add meaningful descriptions of what each action in a stub does.
Use the Comment action to describe difficult steps in a stub and to offer clarity.
Use the Documentation tab of the stub to add a description of the function of the stub.
Create data-driven stubs. The data that is defined in spreadsheets or any other data sources can cover as many test cases as possible, reducing the number of stubs to implement. When recording events, the data fields that are promoted to the events table are used to create the data source.
Sift and pass-through: If there are no live systems or if you are not permitted to access a live system, sift and pass-through is irrelevant. However, if a live system must be accessed, set up the stubs up to look for identifiers within messages, and pass-through to the live system any messages that do not contain those identifiers.