Release 10.1A: OpenEdge Development:
Web Services

> ## Handles for accessing a Web service

> Table C–1 lists the 4GL handles that are either valid only for accessing a Web service or have special application in Web service client programming. The remaining chapters explain how to use these 4GL elements.

> Table C–1: Handles to access Web services
> 4GL handle | Description
> --- | ---
> Asynchronous request object handle. | A type of handle that maintains the status of an asynchronous request in a 4GL client application. This handle provides methods and attributes that allow you to check the status of an asynchronous Web service operation.
> `ERROR-STATUS` system handle. | Provides access to the error information returned from processing a Web service request. If the error resulted from a SOAP fault, the SOAP fault is returned as a SOAP fault object.
> Procedure object handle. | A handle to a type of procedure object (Web service procedure object) that provides the interface to a port type of a Web service. port type operations are represented as 4GL internal procedures and user-defined functions within the procedure object that represents the specified port type. A single Web service binding supports one associated port type.
> `SELF` system handle. | In the context of an asynchronous event procedure, returns the asynchronous request object handle of the completed request for which the event procedure is executing.
> Server object handle. | A handle to a server object that can provide a logical connection (or binding) to a Web service from a 4GL client application. The handle provides methods and attributes that allow you to logically connect (or bind) the server object to a Web service and manage the Web service binding.
> `SESSION` system handle. | Maintains Progress session status, including a list of all server objects created by the session to bind Web services.
> SOAP fault object handle. | A handle to an object that contains SOAP fault information for a Web service request. This system handle provides the SOAP fault object handle as the value of its `ERROR-OBJECT-DETAIL` attribute.
> SOAP fault-detail object handle. | A handle to an object that references any `<detail>` element returned in a SOAP fault message generated for a Web service request. The SOAP fault object handle provides any SOAP fault-detail object handle as the value of its `SOAP-FAULT-DETAIL` attribute.
> SOAP header object handle. | A handle to an object that contains the SOAP header for a SOAP request or response message generated for a Web service operation. This can be either an existing header from a SOAP response message, or a newly-created header for a pending SOAP request message.
> SOAP header-entryref object handle. | A handle to an object that references an entry of a SOAP header, either an existing entry from the header of a SOAP response message, or a newly-created entry for a pending SOAP request message.
> X-document object handle. | A handle to an XML document object created for any SOAP message content that you must access as XML.
> X-noderef object handle. | A handle to any XML element (node object) within an XML document object that contains SOAP message content. This allows you to access the actual text of elements in the XML document retrieved as X-noderef objects.

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