1.1.2.1.1 Defining the SOAP Header

The mapsoapheader attribute is used to configure SOAP headers. It defines an FML32 field that represents the SOAP header. It is TA_WS_SOAP_HEADER STRING type.

Note:

The mapsoapheader attribute It is defined in wssoapflds.h file shipped with SALT.

Following is an example of SOAP header definition:

Example 1-1 SOAP Header Definition

<Definition ...>
<WSBinding id="simpapp_binding">
<Servicegroup id="simpapp">
<Service name="toupper">
<Property name="mapsoapheader" value="true" />
</Service>
</Servicegroup>
....
</WSBinding>
</Definition>

The mapsoapheader attribute default value is "false" which indicates the GWWS does not execute mapping between the SOAP header and FML fields.

If mapsoapheader is set to true, the mapping behavior is as follows for inbound and outbound services:

  • Inbound

    For inbound services, the GWWS translates the SOAP header as shown in the example below:

Example 1-2 GWWS Soap Header Translation

<cup:SoapHeader xmlns:cup='http://www.xxx.com/soa/esb/message/1_0'>
<cup:Head>
<cup:Name>xxx</cup:Name>
<cup:Value>xxx</cup:Value>
</cup:Head>
</cup:SoapHeader>

The string buffer is assigned to the TA_WS_SOAP_HEADER field and injects the target FML32 buffer. If the target buffer type is not FML32, the translation will not take effect.

  • Out Bound

    For outbound services, the GWWS receives the TA_WS_SOAP_HEADER from the request buffer and places it in the SOAP header when the SOAP package is composed.

Parent topic: Creating a Native WSDF