SOAP 1.2 operation Element (Using the HTTP Binding Component)

Using the HTTP Binding Component

SOAP 1.2 `operation` Element

The SOAP 1.2 operation element provides binding information from the abstract operation to the concrete SOAP operation.

Table 10 SOAP 1.2 operation Element Attributes


Property	Description	Required or Optional	Example
soapAction	Indicates the action parameter carried in the application/soap+xml Content-Type header field	Optional	urn:someSoapAction
style	Indicates the default style of this particular SOAP operation	Optional	rpc
soapActionRequired	Indicates whether the value of the soapAction attribute is or is not required to be part of request message	Optional	true

The following example illustrates the use of the SOAP operation element.

<definitions ....>;
    <binding .... >;
        <operation .... >;
           <soap12:operation soapAction="xs:anyURI" ?
                              soapActionRequired="xs:boolean" ?
                              style="rpc|document" ?
                              wsdl:required="xs:boolean" ? /> ?
        </soap12:operation>
    </binding>;
</definitions>

The style attribute value, if present, is a string that specifies the style for the operation. The style attribute indicates whether the operation is RPC-oriented (a messages containing parameters and return values) or document-oriented (a message containing documents). If the style attribute is omitted from the soap12:operation element, then the operation inherits the style specified or implied by the soap12:binding element in the containing wsdl:binding element.

The soapAction attribute (of type xs:anyURI) specifies the value of the action parameter, carried in the application/soap+xml Content-Type header field, for this operation. The value of this attribute must be an absolute URI.

The soapActionRequired attribute (of type xs:Boolean), if present, indicates whether the value of the soapAction attribute is or is not required to be conveyed in the request message. If the soapActionRequired attribute is omitted, its value defaults to true. When the value of soapActionRequired is true, the soapAction attribute must be present