HCL OneTest API and Rational® Software Architect Designer

With Rational® Software Architect Designer, you can design an organization's services, which include technical description, technical documentation, and links to other technical documentation. As a tester, you can pull this information into HCL OneTest API by using a WSDL or WADL add operation and populate the Architecture School quickly and accurately. HCL OneTest API parses the added documents in a way that you can directly use them in your testing.

Before you begin

Install Rational® Software Architect Designer, Version 9.5.0 or later. For installation instructions, see Installing and updating Rational® Software Architect Designer.
Note: The processes of preparing for the integration and adding the transformed documents to HCL OneTest API projects are independent of each other. Hence, you can install Rational® Software Architect Designer on the same computer as HCL OneTest API or a different one.

About this task

The integration process involves two steps:

Preparing for the integration

The integration setup is handled in Rational® Software Architect Designer and the process involves creating model projects and then transforming them into WSDL or WADL documents.

Procedure

  1. In Rational® Software Architect Designer, create a model project or import an existing one. For details, see Before you begin section under "Creating UML models" in the Rational® Software Architect Designer documentation.
  2. Create a UML model of a web service or a REST service. For details, see Creating UML models in the Rational® Software Architect Designer documentation.
  3. Transform the model:
    • For web service models, select the extension that generates Rational® Software Architect Designer model elements in WSDL for HCL OneTest API and then run the transformation.
    • For REST service models, select the extension that generates Rational® Software Architect Designer model elements in WADL for HCL OneTest API and then run the transformation.

    The generated extension elements in the WADL and WSDL documents provide information about the Rational® Software Architect Designer project. For details about how to configure and run model transformations, see Transforming models in the Rational® Software Architect Designer documentation.

Results

The initial setup for the integration between HCL OneTest API and Rational® Software Architect Designer is ready.

What to do next

Adding WSDL and WADL documents as synchronization sources

Before you begin

Make sure you have the initial setup ready. See Preparing for the integration for details.

About this task

You can add a WSDL document or a WADL document (generated from Rational® Software Architect Designer extensions) to your HCL OneTest API project as an external synchronization source that can be synchronized with the project.

For information about adding WSDL and WADL documents as synchronization sources, see Adding a WSDL document as a synchronization source and Adding a WADL document as a synchronization source.

Results

HCL OneTest API parses the Rational® Software Architect Designer extensions from the WSDL and WADL documents. It then populates the information into the Documentation tab of either the Service Component or the Environment that you create or select during the process. For sample WADL and WSDL fragments, and screen shots, see Examples: Rational Software Architect Designer extensions.