CallSOAPWebService
The CallSOAPWebService function allows for consuming a SOAP web service.
Properties
Misc
Method name
The name of the web method to call. The web method can be selected from a drop-down box on the editor window after specifying the URI (typically ending with ?wsdl ) or the file path to the WSDL document describing the web service.
Service URL
The URL to use when making the SOAP call.
Settings
Allows to override the default values of various settings on the binding like timeouts and message size limits.
Eg.
The values above will set the operation timeout to 10 minutes (overriding the default of 1 minute), and set the maximum message size that the binding will process to 1,048,576 bytes (overriding the default of 65,536 bytes).
See Binding Settings below for the list of available settings.
Security mode
The type of security to use.
- None specifies no web service security.
- Transport enables transport-level security. The scheme of the Service URL must be https.
- Message enables message-level security (WS-Security).
Windows authentication
If the service requires Windows-authentication and is hosted on a server on a different domain, then a Windows credential needs to be supplied.
Windows authentication
Username
The username to use to authenticate with the service.
Password
The password to use to authenticate with the service.
Domain
The domain of the host, if required.
Binding Settings
The following binding settings can be specified using the Settings property:
OpenTimeout
Default: 1 minute
The interval of time provided for a connection to open. This time span includes all necessary security handshakes, protocol negotiations etc.
CloseTimeout
Default: 1 minute
The interval of time provided for a connection to close. This time span includes all necessary security handshakes, protocol negotiations etc.
SendTimeout
Default: 1 minute
The interval of time provided for the entire service call to complete, from sending the request to receiving the response.
MaxReceivedMessageSize
Default: 65,536 bytes
The maximum size of received messages in bytes.
MaxBufferPoolSize
Default: 524,288 bytes
The maximum amount of memory, in bytes, allocated to the buffer manager for processing messages.
The buffer pool helps decrease the overhead due to memory allocation (and subsequent gargabe collection) while processing messages. A buffer pool size that is too small can cause degradation of performance due to extensive allocation from the CLR garbage heap.
MaxBufferSize
Default: 65,536 bytes
Available only when Security mode is set to None. Sets the maximum size, in bytes, of the buffer that receives messages from the channel.
TextEncoding
Default: UTF8
The character encoding that is used for transmitting text.
Allowed values: BigEndianUnicode, Default, Unicode, UTF32,
UTF7, UTF8
TransferMode
Default: Buffered
Available only when Security mode is set to None. Selects if messages are sent buffered or streamed.
Allowed values:
Buffered Request and response messages are both buffered.
Streamed Request and response messages are both streamed.
StreamedRequest The request message is streamed, and the response is buffered.
StreamedResponse The request message is buffered, and the response is streamed.
MessageEncoding
Default: Text
Selects if SOAP messages are encoded as Text/XML or MTOM.
Allowed values:
Text
Encodes all values as text in the XML content using the binding's text encoding.
Mtom
Efficiently encodes all lists of bytes, adding them as binary-coded attachments referenced from the XML content.