wsSOAPAddHeader

Home > Books > NetKernel API and Services Reference > Accessor Listing > SOAP Service Infrastructure > wsSOAPAddHeader

Module

The wsSOAPAddHeader accessor is exported by the urn:org:ten60:netkernel:mod:ws module. Import this module to gain access to the accessor.

Syntax

URI

active:wsSOAPAddHeader

Argument	Rules	Description
message	Mandatory	the SOAP message
header	Mandatory	the SOAP header to add to the message
action	Optional	an optional action URI - valid for SOAP1.1 messages
role	Optional	an optional role URI - valid for SOAP1.2 messages
mustUnderstand	Optional	an optional mustUnderstand indicator

Example Usage

DPML

<instr>
  <type>wsSOAPAddHeader</type>
  <message>var:SOAPmessage</message>
  <header>
    <ns:MyHeader xmlns:ns="http://my-header-uri">
      <something />
    </ns:MyHeader>
  </header>
  <action>http://some-action-uri</action>
  <mustUnderstand>urn:true</mustUnderstand>
  <target>this:response</target>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:wsSOAPAddHeader");
req.addArgument("message", [resource representation, aspect, or URI] );
req.addArgument("header", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

The wsSOAPAddHeader accessor adds a new Header fragment to a SOAP 1.1 or 1.2 Message. It creates a new SOAP Header if the supplied message does not already have one. The updated message is returned as the result.