SET-NODE( ) method

Replaces the underlying XML of a SOAP-header-entryref object with the DOM XML sub-tree rooted by the X-noderef object.

Return type:

LOGICAL

Applies to:

SOAP-header-entryref object handle

 

Syntax 

SET-NODE ( x-noderef )

x-noderef

A variable of type X-noderef that refers to the XML that will become the SOAP-header-entryref object.

The supplied X-noderef object corresponds to the SOAP header entry element. The method performs a deep copy of the X-noderef object and its sub-tree and adds namespace declarations to the SOAP-header-entryref as necessary. For example, if the X-noderef object uses a namespace that is declared in its parent tree by an ancestor of the X-noderef object, that namespace declaration is carried over to the SOAP-header-entryref object.

Care must be taken to distinguish between a SOAP header entry and how it is represented in ABL. A SOAP header is represented by the SOAP-header object. A SOAP header entry is represented by a SOAP-header-entryref object. The SOAP-header object maintains a list of pointers to existing SOAP-header-entryref objects that have been explicitly associated with the SOAP-header object by calling its ADD-HEADER-ENTRY( ) method.

Before you can use the SET-NODE( ) method on the SOAP-header entryref object, it must be associated with its SOAP-header object. Call the SOAP-header object’s ADD-HEADER-ENTRY( ) method prior to calling the SET-NODE method( ) or the SET-SERIALIZED method( ) for the first time. Otherwise, you will get a run-time error.

If you call either the SET-NODE( ) or SET-SERIALIZED( ) method twice in a row with the same SOAP-header-entryref, the second call will overwrite the underlying SOAP header entry created by the first call. Although you can use the same SOAP-header-entryref object to create more than one SOAP header entry, you need to call the ADD-HEADER-ENTRY() method between calls to these methods to create a new entry on the SOAP-header object’s list and associate the new entry with the current content of the SOAP-header-entryref object.