Try OpenEdge Now
skip to main content
Web Services
ABL Elements for Consuming OpenEdge SOAP Web Services : Handles for consuming a Web service
 

Handles for consuming a Web service

The following table lists the ABL handles that are either valid only for consuming a Web service or have special application in Web service client programming.
Table 58. Handles to consume Web services
ABL handle
Description
Asynchronous request object handle
A type of handle that maintains the status of an asynchronous request in an ABL 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 ABL 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 an ABL 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 ABL 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.