Web service Jitterbit variables¶
Introduction¶
This page covers Jitterbit variables that are available for SOAP endpoints, organized by informational variables that you read (Informational), and settings variables that you write (Settings).
Informational¶
jitterbit.webservice.last_fault
¶
Data type¶
String
Description¶
The last XML-formatted SOAP fault response when referenced downstream of a SOAP activity. If no SOAP faults are generated or if the faults are not derived from 5XX
server errors, this variable will remain unset. This variable is supported when using agent versions 10.68 or later or 11.6 or later.
The XML string can be read directly or transformed using the schemas below:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<root>
<transaction>
<soap:Fault xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode xmlns="">soap:Server</faultcode>
<faultstring xmlns="">Fault</faultstring>
</soap:Fault>
</transaction>
</root>
<?xml version="1.0" encoding="utf-8"?>
<root>
<transaction>
<soap:Fault xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Code>
<soap:Value>soap:Receiver</soap:Value>
</soap:Code>
<soap:Reason>
<soap:Text xml:lang="en">Fault</soap:Text>
</soap:Reason>
<soap:Detail/>
</soap:Fault>
</transaction>
</root>
jitterbit.web_service_call.status_code
¶
Data type¶
Integer
Description¶
The response status code returned from a SOAP activity when used in an operation. If no status code is returned, the reported value is -1
.
Settings¶
jitterbit.web_service_call.max_redirs
¶
Data type¶
Integer
Default value¶
0
Description¶
Maximum number of redirects to follow when calling a SOAP endpoint. Set to a negative number to follow any number of redirects. The default is 0
(zero); no redirects are followed.
jitterbit.web_service_call.number_of_retries
¶
Data type¶
Integer
Description¶
If a call to a SOAP endpoint fails with any status code except 400
or 403
, retry this many times. The default is to not try again.
Note
This setting is overridden by the Max Retries configuration field available under Retry in a SOAP connection.
jitterbit.web_service_call.retry_wait_seconds
¶
Data type¶
Integer
Description¶
If a call to a SOAP endpoint fails and retries are enabled by setting $jitterbit.web_service_call.number_of_retries
to a positive integer, wait this many seconds between retries.
Note
This setting is overridden by the Retry Interval (Seconds) configuration field available under Retry in a SOAP connection.
jitterbit.web_service_call.ssl_cert_id
¶
Data type¶
String
Description¶
An identifier for a configuration entry in the configuration file jitterbit.conf
for the SSL certificate to use for SOAP endpoints. Also see Customizations > Client Certificates and Adding certificates to keystore for private agents.
jitterbit.web_service_call.sync_response
¶
Data type¶
Boolean
Default value¶
true
Description¶
Set to false
to skip a step in processing of SOAP endpoint responses. This step is necessary only when processing SOAP arrays and can be skipped in other cases. The default is true
, meaning this step is always performed.
jitterbit.web_service_call.time_out
¶
Data type¶
Integer
Description¶
Set the number of seconds after which SOAP endpoint calls will time out, or set to 0
(zero) to disable. The default transfer time-out for SOAP endpoint calls is one hour (3600 seconds).