The SOAP header-entryref object handle provides two methods for accessing the element subtree of the SOAP header entry that it references, as shown in the following figure.

Figure 1. Accessing entry elements in the SOAP header object model


The SOAP header-entryref object handle provides two methods to access the XML in the header entry that it references:

  • GET-NODE( ) method—assigns an X-noderef object to reference the root node of the header entry in the DOM subtree of the header entry. You can then use this X-noderef object to examine the XML elements by walking and returning values for the nodes of the header entry DOM subtree.
  • GET-SERIALIZED( ) method—assigns a LONGCHAR value that contains the entire header entry as a serialized XML string that you can parse yourself using either the ABL SAX reader or DOM parser.

The SOAP header-entryref object handle also provides two corresponding methods for replacing the entire content of the SOAP header entry that it references:

  • SET-NODE( ) method—replaces the content of the header entry with the DOM subtree whose root node is currently referenced by a specified X-noderef object.
  • SET-SERIALIZED( ) method—replaces the content of the header entry with a DOM subtree that it parses from a specified LONGCHAR value containing the serialized XML for the header entry that you can build and write using a DOM tree or the ABL SAX writer.

For more information on these objects and all the attributes and methods that they support, see Creating and managing SOAP message headers.

In the rare instances when the WSDL Analyzer identifies a temp-table or ProDataSet definition that maps to the header entry, you can use the GET-SERIALIZED( ) and SET-SERIALIZED( ) methods in conjunction with the READ-XML( ) and WRITE-XML( ) methods of the documented ABL object (temp-table or ProDataSet) to access or build the header entry.