Setting up a new synchronization source

You can set up a WSDL document in an IBM® WebSphere® Service Registry and Repository server instance as a synchronization source in an HCL DevOps Test Integrations and APIs (Test Integrations and APIs) project.

Note: Only SOAP 1.1 and SOAP 1.2 bindings are supported. Any schema definitions that are not referenced by an operation that uses at least one of these bindings is ignored.

About this task

Before synchronizing with a WSDL document in a WebSphere® Service Registry and Repository server instance, you must first create a physical Test Integrations and APIs connection to that WebSphere® Service Registry and Repository server instance.

Procedure

  1. Open the Logical View of the Architecture School perspective of Test Integrations and APIs.
  2. Open the toolbar of Logical View, click Web > WSDL. The Synchronization Source window in the Create a new Synchronization Source wizard is displayed. Look for WSDL in the Type list.
  3. Click New. The Select Location window is displayed.
  4. Click Registry next to the Location field. The Browse Service Registry window is displayed.
  5. Verify that the Service Registry URL list displays the WebSphere® Service Registry and Repository server instance that you want to use.
  6. Optionally, you can perform any of the following tasks:
  • In the Name field, enter the full or partial name of the WSDL document that you want to import. You can use an asterisk (*) as a wildcard.
  • Select the Exact Name Match check box if you want to search WSDL documents in the selected WebSphere® Service Registry and Repository server instance only by exact names.
  • Select the Case Sensitive check box if you want your search of WSDL documents in the selected WebSphere® Service Registry and Repository server instance to be case-sensitive.
  1. Click Find WSDL Documents to search for the WSDL document that you want to import. Depending on the search parameters that you selected, search results are displayed in the Browse Service Registry window.
  2. Double-click the relevant web service. The WSDL documents associated with the selected web service are displayed.
  3. Select the WSDL document that you want to import.
  4. Click OK to close the Browse Service Registry window.
  5. Click OK to close the Select Location window. The selected WSDL document is displayed in the Configuration area on the Synchronization Source window in the Create a new Synchronization Source window.
  6. Click Next. The Generate Assets for Operation window in the Create a new Synchronization Source wizard is displayed.
  7. To generate tests and virtual services for the operation, click Create Tests and Create Stubs. You can modify the name of the asset or continue to use the default name.
  8. Click Next. The Create Test for Operation window of the Create a new Synchronization Source wizard is displayed.
  9. For each test you requested, provide the following information:
    Note: The number of tests to be created is shown in the Test creation progress bar at the bottom of the window.
    1. Select a source option for the Input message:
      Generate message from Schema
      Use the schema information from the source document to generate the Input message.
      Specify a message
      Create your own message. You can enter the message in the text box that is provided, paste it from your copy/paste buffer, or browse to a file that contains the message. The message can be in XML, JSON, or any other supported message format.
    2. Select Include optional schema fields to complete the message with optional fields from the schema that is provided by the source document.
    3. Select a source option for the Output message.
      The options that are available are the same as the ones for the Input message, with the exception that you can opt to not generate an Output message.
    4. Click Next and repeat this step for each of the generated tests.
    When you have specified sources for all selected tests, a Summary page is displayed with the number of synchronization items, tests and stubs that were created. Starting from Test Integrations and APIs Version 10.0.0, the Summary page displays all information, warning, and error messages that occurred during synchronization.
  10. Click Finish. The Test Factory perspective is displayed.

Results

Test Integrations and APIs imports the selected WSDL document and adds it as a synchronization source to the logical model of your project.

Depending on the synchronization option chosen in the Create a new Synchronization Source wizard, the new WSDL document is also synchronized with the source WSDL document on the WebSphere® Service Registry and Repository server instance.