Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Dynamic system settings for SOAP integrations

Updated on April 6, 2022

Pega Platform provides dynamic system settings that you can use to modify SOAP integrations in your system. For example, you can modify the time and number of idle HTTP connections if a high system load negatively affects the performance of SOAP connectors.

For more information about updating dynamic system settings, see Editing a dynamic system setting.

The following table provides the dynamic system settings that you can configure for your SOAP integration:

SOAP integration settings

Owning rulesetNamePurposeValue typeDefault value
Pega-IntegrationEngineAxis2_IdleTimeoutLimits the amount of time that the system holds idle HTTP connections in the requestor-level connection pool before evicting or closing the connections.

Consider changing this value if periods of high system load negatively affect the SOAP connector performance.

Integer (milliseconds)180000
Pega-IntegrationEngineAxis2_Max_ConnectionsLimits the total number of idle HTTP connections that the system holds in the requestor-level connection pool.

Consider changing this value if periods of high system load negatively affect the SOAP connector performance.

Integer100
Pega-IntegrationEngineAxis2_Max_HostConnectionsLimits the number of idle HTTP connections to a particular host that the system holds in the requestor-level connection pool.

Consider changing this value if periods of high system load negatively affect the SOAP connector performance.

Integer1000
Pega-IntegrationEngineDisableEpochDateTimePrevents the inclusion of default date values of the 19700101 format when mapping empty date values from the clipboard during XML serialization.

When you set this dynamic system setting to true, the system leaves the serialized XML value blank.

Booleanfalse
Pega-IntegrationEngineDisableMustUnderstandHeaderPrevent run-time failures in SOAP connectors that occur when the SOAP response contains a SOAP header that has a mustUnderstand attribute with a value of true or 1.

When you set this dynamic system setting to true, the SOAP connector run time suppresses the third-party code that returns an exception when the mustUnderstand attribute is present.

Booleanfalse
Pega-IntegrationEngineEnableJCIFSEngineEnables the use of the JCIFS open-source library for SOAP or REST connectors that use NTLMv2 authentication.

When you set this dynamic system setting to true, the connector uses the JCIFS library instead of the default Apache library for authenticating the connection.

Note: As licensing restrictions prevent the JCIFS library from being distributed with Pega Platform, install the JCIFS library into the Pega classpath as a separate step.
Booleanfalse
Pega-IntegrationEngineEnableRequestOnlyFaultMappingDetects server-side processing failures in SOAP connectors when the configuration uses the Request only option.

When you set this dynamic system settings to true, the connector waits for the service endpoint to return a SOAP fault message in case the request is not successfully processed. By default, the connector does not wait for a response or detect server-side processing failures.

Booleanfalse
Pega-IntegrationEngineHTTPS/AllowAllHostnamesControls the mechanism to temporarily bypass the SSL/TLS security checks, which can be useful during the development of Pega applications that use SOAP or REST connectors.
Important: Do not set this dynamic system setting to true in production environments, as it significantly lowers the level of protection from malicious attacks.
Booleanfalse
Pega-IntegrationEngineParseXML/DOM/DoNotConvertBooleanValuesDetermines whether to retain the original Boolean value from the source XML when mapping to a TrueFalue property on the clipboard during XML parsing.

When you set this dynamic system setting to true, the TrueFalse property follows the XML source value, which can be any of the following values:

  • true
  • false
  • 1
  • 0
Otherwise, the value set on the clipboard is either true or false.
Booleanfalse
Pega-IntegrationEngineStreamXML/DetectEmptyPropertiesPrevents the inclusion of unwanted element or attribute tags for properties that contain an empty string or empty list value during XML serialization.

The default behavior during XML serialization is to include these tags depending on the presence or absence of the property on the source clipboard page. This behavior can be an unreliable way to determine whether the application has set the property.

Note: Changes to this value require a revalidation and resave of all XML Stream rule instances.
Booleanfalse
Pega-IntSvcsXML/RemoveEmptyPropertiesFromPagePrevents the inclusion of unwanted element or attribute tags for properties that contain an empty string or empty list value during XML serialization.

When you set this dynamic system setting to true, the system purges the source page of empty properties before the XML serialization.

Note: This setting is an alternative to the StreamXML/DetectEmptyProperties dynamic system setting that does not require you to resave existing XML Stream rules.
Booleanfalse
Pega-IntegrationEngineSwitchToOldAssemblerControls the run-time implementation of Parse XML rules.

Consider changing this value if slow XML parsing negatively affects the performance of the SOAP connector.

Note: Changes to this value take effect immediately and do not alter the values that are mapped to the clipboard from the source XML.
Booleanfalse

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us