This topic explains how to configure and apply the WS-I tool in SOAtest and Virtualize. This tool checks WSDL conformance to WS-I's Basic Profile 2.0 (for SOAP 1.2) or 1.2 (for SOAP 1.1). It can also be added to the Traffic Object output of a SOAP Client for validating SOAP message conformance. Sections include:
Understanding WS-I
This tool checks WSDL conformance to:
- The WS-I Basic Profile 2.0 interoperability specifications (2010) apply to SOAP 1.2.
- The WS-I Basic Profile 1.2 interoperability specifications (2010) apply to SOAP 1.1.
Verifying conformance to WS-I is especially useful in ensuring the interoperability of your service. By restricting service development to the technologies specified in the Basic Profiles, you can increase the odds that your service will interoperate with others’ systems. In the case of non-conformance, you can pinpoint exactly what needs to be changed to ensure interoperability.
The tool parses the WSDL, passes it to the Test Tools and produces a WS-I conformance report that can be viewed in a web browser or in the SOAtest or Virtualize internal editor. In addition to analyzing WSDLs, it can also analyze SOAP messages and validate their conformity to WS-I assertions.
As a test suite tool, it allows you to check WSDLs as part of your functional test scenario. As an output to a test suite’s SOAP Client tool, it can validate SOAP messages. To check interoperability during static analysis, use the "Check WS-I Interoperability" rule, which is in the Interoperability category. This rule has the same customization options as the WS-I tool.
Download and Installation
- Download the WS-I Testing Tools for Basic Profiles 1.2 and 2.0 from http://www.ws-i.org/Profiles/BPTestToolsProcess-1.2-2.0-Final.zip.
- Copy the zip file to
<SOATEST_INSTALL>\plugins\com.parasoft.ptest.libs.web_<VERSION>\root\wsi.
Analyzing SOAP Messages for WS-I Conformance
The WS-I tool can be added to the Traffic Object output of a SOAP Client for validating SOAP message conformance.
Customizing WS-I
You can customize the following options for all configurations:
- WSDL: Specifies the WSDL you would like to check.
- Profile: Specifies which Basic Profile you want to check conformance to.
When the tool is chained to the Traffic Object output of a SOAP Client, you can also customize the following option:
- Suppress request assertion failures: When enabled (default), any Basic Profile violations for the SOAP request are ignored.
Conformance Report Output
The WS-I tool produces an output file that contains the conformance report for the Web service corresponding to the WSDL you entered. This conformance report displays the test results for the assertions that have been processed. Also, the conformance report displays the conformance level for each test assertion that was processed and may list detailed information for any errors that were encountered. The report also contains a summary of the test assertions results that indicate if the Web service passed or failed the conformance test.
After you have customized the WS-I tool, you can chain an Edit or Browse tool to display the output of the WS-I conformance report. To do so, complete any of the following:
- Right-click the WS-I test node and choose Add Output. The Add Output dialog opens. Select Conformance Report from the left pane and Browse from the right pane, then click Finish. After you run the WS-I test, a browser window will open and display a WS-I Profile Conformance Report.
- Right-click the WS-I test node and choose Add Output. The Add Output dialog opens. Select Conformance Report from the left pane and Edit from the right pane, then click Finish. After you run the WS-I test, the WS-I Profile Conformance Report displays in the right GUI panel.
For more information on the WS-I tool specifications, or for more information on WS-I conformance reports, see http://www.ws-i.org.
Related Tutorials
The following tutorial lesson demonstrates how to use this tool:
