Accessing Adabas through SoapUI

This simple scenario demonstrates how to invoke operations on an Adabas DataSource exposed as a "Web service" through SOA Gateway from SoapUI.

soapUI is a (freeware) desktop application for inspecting, invoking, developing and functional / load / compliance testing of web services over HTTP and can be downloaded here.

Additionally, soapUI can be integrated into the Eclipse framework, read here for more information.

  1. When starting soapUI for the very first time an "empty" workspace is generated, right-click on the top-level Projects item, select New WSDL Project to create your first soapUI project.

    graphics/soapui01.png

    You will be prompted for a project name, enter one and click OK:

    graphics/soapui02.png

    Specify a target location for the project files, click Save:

    graphics/soapui03.png

  2. Now import an SOA Gateway "web service" into the newly created project, right-click the project name, then select Add WSDL from URL

    graphics/soapui04.png

    Enter the URI of the adabas_Employees_special resource, as in http://<yourASGserverhost>:<yourASGserverport>/adabas_Employees_special?WSDL and click OK to import the webservice definitions from the resources / WSDL

    graphics/soapui05.png

    You will be asked if default requests for all operations are to be created, click Yes.

    graphics/soapui06.png

  3. Default requests have been generated for all SOA Gateway operations for a webservice, undfold the "list" request by clicking the plus sign left of it, right-click the created Request 1, select Clone Request, this allows for unlimited duplication of the original request, which may be desirable when testing various options or "canning" requests.

    graphics/soapui07.png

    Assign a name to the cloned request, click OK

    graphics/soapui08.png

  4. soapUI now opens the request document.

    graphics/soapui09.png

    Remove the soapenv:Header section, everything from, and including, <soapenv:Header> to </soapenv:Header>

    This leaves you with the soap Body section, which holds all key information:

    graphics/soapui10.png

    Remove all key elements but the personnel_id, enter 300000* as the key value, the request should look like this now, then click the green arrow to send the request to your SOA Gateway server:

    graphics/soapui11.png

  5. The response will look like this - formatted XML

    This response shows "simple" as well as repeating fields like MUs (multiple value fields, here: olive arrows), PEs (periodic groups, pink arrows) and MUs within PEs (blue arrows):

    graphics/soapui12.png