Adding Headers to an Operation

Cloud Application Integration (On-Premises) : Service Development : Working with Web Services : Adding Headers to an Operation

Adding a Header to an Operation

You can add headers to an operation to incorporate additional processing or functionality for the SOAP message. A header element defines the format of the SOAP headers that may be present in a SOAP message (request or response). Headers are optional and can be added to or deleted the request or response in an operation.

For a service first provider web service descriptor, you can:

Add new headers

Edit any headers

Delete any headers

For a WSDL first provider web service descriptor, you can

Add new headers

Edit any headers that you add

Delete any headers that you add or any headers derived from the source WSDL

Edit the Must Understand and Role properties for headers derived from the source WSDL

For a consumer web service descriptor, you can:

Add new headers to the request or response

Edit any headers that you add

Delete any headers that you add

Edit the Must Understand and Role properties for headers derived from the source WSDL

Note:

Integration Server considers all of the headers defined in a web service descriptor to be required. If the header does not exist in the SOAP message at run time, Integration Server throws an error.

While failure when a required header is missing is the correct behavior, Integration Server provides a configuration property to control whether missing required headers in a SOAP response results in an error. If you do not want Integration Server to throw an error in case of missing required headers, set the watt.server.SOAP.ignoreMissingResponseHeader server configuration parameter to true.