Creating logical HTTP connections

In HCL OneTest™ API, tests and stubs reference the logical resources in a project, so you must create at least one logical HTTP connection for each HTTP transport that you want to use.

Before you begin

Ensure that there is at least one environment in your project. If there are no environments, you must create one.

About this task

Two alternative methods to manual creation of a logical HTTP connection are available:


  1. Open the Logical View of the Architecture School perspective.
  2. On the toolbar of the Logical View, click Web > HTTP Connection.
  3. In the New HTTP Connection window, enter a name for the connection in the Name field and click OK. The new logical HTTP connection is displayed in the canvas of the Logical View.
  4. When a logical connection is created, a new physical resource is also created and bound in this environment. To view or edit this physical resource, right-click the new connection and click Physical Resource.
  5. Double-click the new logical HTTP connection.

    The HTTP Connection window is displayed.

    Alternatively, right-click the logical HTTP connection and click Open in the pop-up menu.

  6. If you want to associate the new logical HTTP connection with a different logical resource, complete the following steps:
    1. Click Parent.

      The Select a Resource window is displayed.

    2. Under Logical, select a different parent resource.
    3. Click OK.

      The Resource Path field on the Properties tab of the HTTP Connection window displays the updated resource path information.

  7. Optional: Click the Bindings tab. If you did not bind the HTTP connection to a physical HTTP server resource, UNBOUND is displayed in the Binding column. To bind the HTTP connection, click UNBOUND and choose a web server from the list. If no physical web servers are displayed, you must create one. See Creating physical web server resources.
    Note: Alternatively, you can modify the bindings for an environment in the Environment Editor window (Project > Edit Environments).
  8. Optional: If you want to add a log file for the new logical HTTP connection, click the Monitoring tab.

    The log file can be monitored during the execution of a test that involves the new logical HTTP connection.

  9. Optional: If you want to enter additional information about the new logical HTTP connection, click the Documentation tab. This information can help with the maintenance of the resources in your project or help future users of your project.
  10. Optional: If you want to change the Display Color option for this transport in the Events View, click the Recording Studio tab.
  11. Click OK.


The new logical HTTP connection is added to your project.

What to do next

After you have a logical HTTP connection that is bound to a physical web server in an environment, use those resources to create tests and virtual services (stubs). See Testing with the HTTP transport and Virtualizing HTTP.