Integration Server 10.3 | Built-In Services Reference Guide | SOAP Folder | Summary of Elements in this Folder | pub.soap.handler:removeHeaderBlock
 
pub.soap.handler:removeHeaderBlock
WmPublic. Removes a header block from a SOAP message.
Input Parameters
messageContext
Object Message context that contains the SOAP message from which to remove a header block.
A message context contains properties for the SOAP message as well as providing access to the SOAP message. Integration Server creates the message context and passes it to the header handler. All handlers invoked by a given instance of a SOAP request or SOAP response use the same message context. This enables you to use the message context to pass information between handlers.
QName
Object Optional. Qualified name of the header block to remove. The QName document references the pub.soap.utils:QName document type.
Note:
Either QName or documentType must be supplied.
documentType
String Optional. Fully qualified name of the IS document type that corresponds to the structure of the header block that you want to remove. Integration Server uses the QName of the first element in the IS document type to determine which header block to remove.
Note:
Either QName or documentType must be supplied.
index
String Optional. An integer representing the position of the header block entry with the specified QName to remove. A SOAP message can contain multiple header blocks with the same QName. If you specify an index, Integration Server removes that occurrence of the header block. Note that 0 (zero) represents the first header block with the specified QName.
If index is not provided, Integration Server removes all the header blocks with a matching QName.
For example, if QName is myNSName:myLocalName and index is 1, Integration Server removes the second occurrence of the header block with the QName myNSName:myLocalName.
Output Parameters
status
String Indicates whether Integration Server removed the header block.
Key
Description
True
If index was specified, indicates that Integration Server removed the header block with the specified QName at the specified index.
If index was not specified, indicates that Integration Server removed all the header blocks matching the specified QName
False
If index was specified, indicates that Integration Server did not remove the header block at the specified index.
For example, if QName is myNSName:myLocalName and index is 1, and the SOAP message does not contain a second header with the QName myNSName:myLocalName, the status is false.
If index was not specified, indicates that Integration Server did not remove at least one header block with the specified QName.
Usage Notes
This service replaces pub.soap.handler:removeHeaderElement, which is deprecated.
Either QName or documentType must be supplied. If both are provided, Integration Server uses QName and ignores documentType.