SOAP V1 (Deprecated)

Know the component and how to use it.

The SOAP V1 is deprecated and no longer updated. Please refer to the document with the most recent version of the feature: SOAP V2 or SOAP V3.

SOAP V1 invokes SOAP endpoints from a pipeline. It uses a Apache FreeMarker template to generate the SOAP request message and converts the response from SOAP to JSON, trying its best not to disrupt the translation.

Parameters

Take a look at the configuration options for the component. Parameters supported by Double Braces expressions are marked with (DB).

Parameter	Description	Default value	Data type
URL	URL to be called - it may contain parameters following the {:param1} pattern, which will be replaced by the corresponding input message property.	N/A	String
Content Type	Configures the Content Type and encoding.	N/A	String
SOAP Action	XML call header.	N/A	String
Account	Account to be used by the component.	N/A	String
Template	Apache FreeMarker template for the SOAP message to be sent in the request.	N/A	String
Connection Timeout	Connection expiration time (in milliseconds).	N/A	Integer
Reading Timeout	Maximum time for reading (in milliseconds).	N/A	Integer
Stop On Client Error	If activated, the option will generate an error and suspend the pipeline execution.	N/A	Boolean
Stop On Server Error	If activated, the option will generate an error and suspend the pipeline execution.	N/A	Boolean
Advanced Settings	Advanced configurations.	N/A	Boolean
Allow Insecure Calls To HTTPS Endpoints	When activated, the option allows non-reliable calls to HTTPS endpoints to be made.	N/A	Boolean
Enable Retries	When activated, the option allows new tries.	N/A	Boolean
Maximum Number Of Retries Before Giving Up	Maximum number of retries before giving up the call.	N/A	Integer
Time To Wait Before Each Retry	Maximum time between retries (in milliseconds).	N/A	Integer

Messages flow

Input

The component waits for a message in the following format:

{
	header: {
		"headerA":"valueA",
		"headerB":"valueB"
	},
	body: {
		// message structure that will be replaced by the Dust template
}

Output

• successful

{
    status: XXX,
    body: {},
    headers: {}
}

• with error

{
    error: "error message",
    code: XXX,
    body: {},
    headers: {}
}

For some errors, body and headers are unavailable.

SOAP V1 in Action

About the template variable

The name of the variable can also have minus (-), dot (.) and colon (:) at any position, but they must be escaped with a preceding backslash (\). Otherwise, they can be interpreted as operators.

About numbers substitution

<#assign x=42>
  ${x}
  ${x?string}  <#-- the same as ${x} -->
  ${x?string.number}
  ${x?string.currency}
  ${x?string.percent}
  ${x?string.computer}

Output

42
42
42
$42.00
4,200%
42

Number format

<#setting number_format="0.####">

To check if the field isn't null:

<#if varTest??>${varTest}</#if>

SoapUI calls reprocedures in SOAP V1