Release 10.1A: OpenEdge Development:
Web Services

> ## Scenario 1: Web service deployed but not enabled

> In this scenario, a Web service is deployed but not enabled. At this point:

> 1. The client sends the following connection request:

>     Connect_OrderInfo("","","")

> 2. The WSA gets the request and determines the Web service is disabled. At this point:

> 1. The WSA sends the client a SOAP response containing a SOAP fault.
> 2. The log files do not show any error.

> The following is the SOAP response containing the SOAP fault:

>     <?xml version="1.0" encoding="UTF-8" ?>
>     <soap:Envelope  namespaces defined here…>
>       <soap:Body>
>         <soap:Fault>
>           <faultcode>SOAP-ENV:Server</faultcode>
>           <faultstring>An error was detected … request. (10893)
>           </faultstring>
>           <detail>
>             <ns1:FaultDetail
>               soap:encodingStyle="http://schemas.xmlsoap.org/…/"
>               xmlns:ns1="http://servicehost:8080/wsa/wsa1">
>               <errorMessage xsi:type=“xsd:string">The urn:www-progress-com
>                 :samples:OrderInfo:OrderInfo service is unavailable (10921)
>               </errorMessage>
>               <requestID xsi:type="xsd:string">2e62cab6b81150d5:-
>                 17c6a3c:f1dffbd11b:-8000#1f
>               </requestID>
>             </ns1:FaultDetail>
>           </detail>
>         </soap:Fault>
>       </soap:Body>
>     </soap:Envelope>

> 3. The interface translates the SOAP fault into a SOAP exception.

> 4. The client code catches the SOAP exception.

> 5. The client displays the following error message (assuming the client application has a user interface):

> Note: All .NET client applications should always catch SOAP faults and handle them. If not, the .NET Framework’s default exception handler displays the SOAP fault general error information. This might well hide and cause the loss of the more useful error detail information in the SOAP fault. For client applications without a user interface, all error information must be written to an application log file to ensure it is not lost.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095