pub.soap.utils:removeTrailer
WmPublic. Deletes a trailer from a SOAP message.
Input Parameters
soapData | Object SOAP object containing the trailer that you want to delete. |
trailer | com.wm.lang.xml.Node Optional. The trailer that you want to remove from soapData. (You would obtain the node with the
pub.soap.utils:getTrailers service.) Note: You can use trailer or index to specify the trailer that you want removeTrailer to delete. |
index | StringOptional. Index of the trailer that you want to remove (where index 0 represents the first trailer). index is ignored if trailer is specified. |
Output Parameters
None.
Usage Notes
When you use the trailer parameter, be sure that it specifies the correct node. This service deletes whatever node is specified in trailer, even if the node is not a trailer. For example, if trailer contains the Body element, removeTrailer will delete the entire body of the message.
Note:
Be aware that if you use the index parameter to delete a trailer, you will change the index numbers (positions) of all trailers following the one you deleted. For example, if your message contains four trailers (0, 1, 2, 3) and you delete trailer 1, then the trailers originally at positions 2 and 3 will subsequently occupy positions 1 and 2.
See Also