Skip to main content
Previous section

WSDL-First Service Creation with the SOAP Wizard

Here are the steps for using the SOAP Wizard to generate a Caché Web service from a WSDL:

  1. In Studio, click Tools->Add-Ins->Add-Ins.

  2. On the Add-Ins menu, click SOAP Wizard and then click OK.

    generated description: soapclientwizard1 20112

  3. On the first SOAP Client Wizard screen do the following:

    1. Click URL for the Select a WSDL File or URL option.

    2. Enter the URL of a Web Servics application's WSDL in the Enter a WSDL URL: box.

      generated description: wsdlfirst soapwiz2 20142

    3. Click Next.

  4. You will see the address of the WSDL along with its contents displayed on the lower half of the screen.

    generated description: wsdlfirst soapwiz3 20142

    Select and/or Enter the following information onto the top-half of the screen:

    • Create Client for Web Service.

    • Compile generated classes

    • Class Type as appropriate. Note that this controls the class type of the generated “type” classes, that is, the types for objects passed to or returned from the Web Service.

    • Proxy Class Package: TempService(or whatever might be appropriate for the Web Service you are generating).

    Click Next

  5. The Package Names screen shows you the packages for your generated classes. It also displays the option for using “Unwrapped messages”. See the Note below for more information on this option.

    generated description: wsdlfirst soapwiz4 20142

    Click Next.

  6. The wizard creates and compiles your classes.

    generated description: wsdlfirst soapwiz5 20142

  7. The generated Web methods will only be shells. You must provide the actual implementation. Here is an example Web Method shell:

    Method CelsiusToFahrenheit(Celsius As %String) 
               As %String [ Final, 
                            ProcedureBlock = 1, 
                            SoapAction = "http://tempuri.org/CelsiusToFahrenheit",
                            SoapBindingStyle = document, 
                            SoapBodyUse = literal, WebMethod ]
    {
     // Web Service Method Implementation Goes Here.
    }
    
    Copy code to clipboard
Note:

For more information on WSDL-first development using the SOAP Wizard, read Creating a Web Service Based on a WSDL in the Creating Web Services section of Creating Web Services and Web Clients in Caché.

For more information about “wrapped” and “unwrapped” messages see the SOAP Message Variations section of Creating Web Services and Web Clients in Caché.