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.

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.

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).