SOAP component
The SOAP component is able to post messages to SOAP endpoints. It will wrap the body in a SOAP:Envelope and SOAP:Body creating a valid SOAP Request. When the smart option is enabled it will include all the necessary namespaces and append their prefixes on the nodes. This means you don't have to declare the namespaces in the message, the SOAP Component will add this for you.
Configuration
The SOAP component has the following configuration options:
| Property | Description |
|---|---|
URL | URL to the SOAP endpoint that must be reached. |
Extract | Whether or not the SOAP component should strip away the SOAP:Envelope and SOAP:Body from the response. |
Soap Action | After retrieving all the information from the URL you can select which method of the WSDL you want to call. |
Smart | When disabled, you will have to add all the required namespaces with their prefixes to the xml body yourself. |
Username | When the WSDL uses basic authentication to call the desired action, sets the username. |
Password | When the WSDL uses basic authentication to call the desired action, sets the password. |
Token | When the SOAP endpoint needs an authentication token, it is set as an HTTP header called ApiToken. |
Situational: Header | When the chosen Soap Action requires a SOAP:Header to be set, input fields will appear where you can fill in these header values. |
Header Mappings
The SOAP Component allows the user to override certain fields using pre-specified headers. The property-header mapping for this data-model is specified below:
| Property | Header |
|---|---|
URL | DovetailSoapWsdl |
Extract | DovetailSoapExtract |
Soap Action | DovetailSoapAction |
Smart | DovetailSoapSmart |
Username | Unable to override at this point |
Password | Unable to override at this point |
Situational: Header | Unable to override at this point |
Header Types
| Header | Type |
|---|---|
| DovetailSoapWsdl | String |
| DovetailSoapExtract | true, false |
| DovetailSoapAction | String |
| DovetailSoapSmart | true, false |
Remarks
- This component can be chained to another endpoint. However unlike other components the output will not contain the message you posted somewhere, but will contain the response of the SOAP call.
- The SOAP component also has a Retrieve Information button, which retrieves all the possible methods you can call from your specified SOAP endpoint.
- The SOAP component is only capable of posting messages to SOAP endpoints, it cannot setup a SOAP endpoint.
- Using the
smartoption can be slow and inefficient for larger requests, we recommend to disable this option when processing larger requests. - The basic authentication is only applicable on calling the SOAP Service, not for retrieving the WSDL definition.