Technical Notes

Changing Verastream Host Integrator WSDL References
Technical Note 10113
Last Reviewed 30-Oct-2010
Applies To
Verastream Host Integrator
Verastream Process Designer
Summary

Some third-party technologies have problems consuming web services that use WSDL internal references, such as those generated by the Verastream Host Integrator (VHI) embedded SOAP stack (version 7.0 or higher) or Web Builder-generated web service projects (version 6.6 or earlier). This technical note describes how to convert the WSDL, so the VHI web service can be successfully directly consumed.

Symptom and Solution

When you are importing a web service into an older third-party technology (such as Siebel), it may present an error when it does not understand WSDL internal references. To resolve this issue, you can use a separate tool (such as Verastream Process Designer or soapUI) to convert and re-export the WSDL, then import the converted WSDL in your third-party tool.

Conversion with Verastream Process Designer

Verastream Process Designer (VPD) is a separate product used to orchestrate multiple web services. You can download a time-limited evaluation (trial) version at http://www.attachmate.com/Evals/vpd/eval-form.htm. After installing VPD, use the following steps to convert the Verastream Host Integrator WSDL:

1. Run the Design Studio application.
2. Create a new project. Enter a project name.
3. Import the VHI web service (in the New Project wizard, or click File > Import Service). For more information on the WSDL location, see Technical Note 10092.
4. All internal references are automatically converted to local references, and are stored in the project imports subfolder (such as C:\Users\<username>\Documents\Attachmate\Verastream\ProcessDesigner\workspace\<project>\imports on Windows 7, Windows Server 2008, or Windows Vista).
5. Import these file(s) into your third-party tool.

Conversion with soapUI

The soapUI open source tool is available from http://www.soapui.org/ or http://sourceforge.net/projects/soapui/. After installing soapUI, use the following steps to convert the Verastream Host Integrator WSDL:

1. Create a new soapUI project.
   1. Enter a project name.
   2. Enter the VHI service WSDL. For more information on the WSDL location, see Technical Note 10092.
2. In the project tree, within the new project, right click the WSDL port binding. Click Export Definition.
3. Select the output folder. The WSDL is exported, including its dependencies, with internal references converted to local file references.
4. Import these output file(s) into your third-party tool.

Related Technical Notes

10092	Web Services in Verastream Host Integrator
10998	Verastream Process Designer Technical Notes
40999	Verastream Host Integrator Technical Notes