sa_set_soap_header system procedure

Permits the setting of SOAP headers for SOAP responses. This procedure is used within stored procedures called from SOAP web services.

Syntax
sa_set_soap_header( 
fldname, 
val 
 )
Arguments
  • fldname   Use this VARCHAR parameter to specify the header key, a unique string used to reference the given header entry (it need not be identical to the localname of the val).

  • val   Use this VARCHAR parameter to specify the raw XML of a top level header entry and its children within the scope of a SOAP Header element.

Remarks

All SOAP header entries set with this procedure are serialized within the SOAP Header element when the SOAP response message is sent. A val of NULL is not serialized. If no header entries exist for a SOAP response, then an enclosing Header element, within the SOAP envelope, is not created.

Permissions

None

Side effects

None

See also
Example

The following example sets the SOAP header welcome to Hello:

sa_set_soap_header( 'welcome', '<welcome>Hello</welcome>' )