SOAPAction (-SA)

When the transport is HTTP, many Web services require the SOAPAction field to be added to the HTTP header of a SOAP request. Use the SOAPAction adapter command (-SA) to indicate to the server the intent of the request.

Use one of the following values:

  • NULL ( -SA with no argument), means that there is no indication of the intent
  • Empty string ( -SA ''), means that the intent of the request is provided by the HTTP request URI or Uniform Resource Identifier (no value is specified between the single quotes)
  • URI ( -SA ''), where the intent is provided by the URI

The presence and content of the SOAPAction header field can be used by servers to appropriately filter SOAP request messages.

This is an optional command. The default is no SOAPAction.

-SA soap_action
Specify the intent of the request for the SOAP message.

When using the HTTP adapter as the transport, the HTTP adapter command -HDRI+ must be used to instruct the HTTP adapter to add the specified SOAPAction to the HTTP header.

For example, to specify urn:BorlandBabelIntf-IBorlandBabel#BabelFish as the SOAPAction:

GET("SOAP", "-SA 'urn:BorlandBabelIntf-
IBorlandBabel#BabelFish' -TRANSPORT 'http(-HDR+ -HDRI+ -URL
BorlandBabel.exe/soap/IBorlandBabel -T)'", RequestData)

If the WSDL Importer is used to create the type trees for the SOAP request messages, the value that should be assigned to the SOAP action command can be found in the description of the corresponding operation.

See the Type Tree Importers documentation for more information on the WSDL Importer.