Synchronizing HCL OneTest™ API with the IBM® App Connect Enterprise integration node

You can synchronize HCL OneTest™ API with IBM® Integration Bus so that the logical integration node or a stand-alone integration server asset is populated with service components and other artifacts in the HCL OneTest™ API project. Also, you can select the tests and stubs that are automatically created for the operations.

Before you begin

You must have completed the following tasks:
  • Installed IBM® App Connect Enterprise on a computer, if you already do not have a running IBM® App Connect Enterprise set up.
  • Created an integration node in IBM® App Connect Enterprise or a stand-alone integration server that you want to connect from HCL OneTest™ API.
  • Verified that the IBM® App Connect Enterprise integration node or the integration server that you want to use is running.

  • Configured the credentials for users who can access the integration node or the integration server from HCL OneTest™ API.

  • Configured IBM® App Connect Enterprise to use SSL and set up the required identity stores and key stores in HCL OneTest™ API, if you want to use the Secure Socket Layer (SSL) for communications. See Identity stores and SSL.

  • Opened a project in HCL OneTest™ API and the Logical View is displayed.

Procedure

  1. Open the Create a new Synchronization Source wizard in one of the following ways:
    • Click IBM > IBM Integration Bus integration node on the menu bar in the Logical View or Synchronization View.Image of creating a logical resource.
    • Click the Create Synchronization Source icon and select IBM Integration Bus integration node from the Type list in the Create a new Synchronization Source wizard.Image of creating a resource from Synchronization view.
    The Create a new Synchronization Source dialog is displayed with the IBM Integration Bus integration node option in the Type field.Image of the new Synchronization Source window
  2. Perform the following steps in the Create a new Synchronization Source dialog:
    1. Click New to create a physical resource.

      The New resource dialog is displayed.

    2. Select IBM Integration Bus Integration Node from the list.
      Note: If you want to connect to a stand-alone integration server, you can select the integration server as the Node.
      Image of the new resource window.
    3. Click OK.
      The New IBM Integration Bus Integration Node dialog is displayed.Image of the new resource window for IIB
  3. Complete the following steps in the New IBM Integration Bus Integration Node dialog:
    1. Click the Config tab, if it is not already open.
    2. Enter the information as described in the following table:
      Table 1. Details of the Config tab
      Field Description

      Host
      The hostname or IP address of the computer that hosts either of the following assets:
      • IBM® App Connect Enterprise to which you want to connect.
      • The stand-alone integration server.

      Port
      The port on which IBM® App Connect Enterprise or the integration server is listening for requests.
      Note: The default port can be 4414 and the port assigned by the integration node or the integration server depends on the number of ports already in use.

      Username

      The credentials for the user configured, which includes a user name and its associated password. These credentials are used to access the physical integration node of IBM® App Connect Enterprise or the integration server.

      Password
    3. Click the SSL tab and configure the secure socket layer (SSL) settings based on the information in the following table:
      Table 2. Details of the SSL tab
      Setting Description

      Use SSL

      Select this check box to enable security for the transport. When you select this check box, the other controls on the SSL tab available.

      Server certificates to trust
      Select one of the following menu items:
      Option Description
      None To accept any certificate presented by the server, regardless of its validity. This option is the default option and assumes that you are focused on testing an application rather than the security of the server.
      New To define a new identity store.
      After you define the identity stores, identity stores that are available are displayed in the list.

      Client identities to give to the server
      Select one of the following menu items:
      Option Description
      None If the server does not request an identity.
      New To define a new identity store.
      After you define the identity stores, identity stores that are available are displayed in the list.
    4. Click the Config tab, and then click Test to test whether the connection is established with IBM® App Connect Enterprise or the integration server.

      A message is displayed for a successful connection. If an error message is displayed, you must fix the error and ensure that the connection is established before you continue.

    5. Click OK.
    The integration servers that are deployed on the integration node of IBM® App Connect Enterprise are displayed in the list of integration servers or the integration server you connected to is displayed.

    You can skip the following step if you are connecting to a stand-alone integration server and go to Step 5.

  4. Select the integration servers that you want from the list.

    You can use multiple integration servers as synchronization sources.

    Note: You can select all the integration servers by clicking Select All. If all items are selected in the list, you can clear the selection by clicking Deselect All, and then select the items that you want. To get a fresh list of the connected integration servers at any time, you can click Refresh.
  5. Change the default environment in your project if you want to use a different environment in the Environment panel.
    Choose from any of the following options:
    • If you want to continue with the creation of the logical components automatically for the selected integration servers, continue with the next step.
    • If you want to manually create the logical components, select Show advanced options, and then click Next.

      You can follow the on-screen instructions to create logical components.

  6. Click Next.

    The Generate assets for Operations window is displayed with the logical component and operations created for the service endpoints deployed on the node.

  7. Select the tests and stubs that you want or select all by clicking Create Tests and Create Stubs.
    Image of the generate assets for operations window.
  8. Click Next.
    The Create Test for Operation window is displayed.
    Note: Depending on the tests to be created for the operations, you might want to click Next in each window to complete the creation of tests.
    Image of the create test for operation window.
    The Summary window is displayed with the items synchronized that includes tests and stubs that are created.Image of the Summary window.
  9. Click Finish.
    The created tests are opened in the Test Factory view.Image of the Summary window.

Results

You have successfully created tests and stubs in HCL OneTest™ API for the applications deployed on the IBM® App Connect Enterprise integration node or a stand-alone integration node by using the synchronization feature.

What to do next

You can now run the tests for the IBM® App Connect Enterprise applications in HCL OneTest™ API. See Running tests and stubs.