Generic Properties

Given below is a list of the generic properties.

Name	synapse.isresponse
Possible Values	"true", "false"
Default Behavior	none
Scope	axis2
Description	Once this property is set to 'true' on a message, the ESB will start treating it as a response message. It is generally used to route a request message back to its source as the response.
Example	<property name="synapse.isresponse" value="true" scope="axis2"/>

Name	PRESERVE_WS_ADDRESSING
Possible Values	"true", "false"
Default Behavior	none
Scope	synapse
Description	By default, the ESB adds a new set of WS-Addressing headers to the messages forwarded from the ESB. If this property is set to "`true`" on a message, the ESB will forward it without altering its existing WS-Addressing headers.
Example	<property name="PRESERVE_WS_ADDRESSING" value="true"/>

Name	RESPONSE
Possible Values	"true", "false"
Default Behavior	none
Scope	synapse
Description	The same as `synapse.isresponse` property. It is recommended to use this property to flag messages as responses instead of the `synapse.isresponse` property.
Example	<property name="RESPONSE" value="true"/>

Name	OUT_ONLY
Possible Values	"true", "false"
Default Behavior	none
Scope	synapse
Description	Set this property to "true" on a message to indicate that no response message is expected for it once it is forwarded from the ESB. In other words, the ESB will do an out-only invocation with such messages. It is very important to set this property on messages that are involved in out-only invocations to prevent the ESB from registering unnecessary callbacks for response handling and eventually running out of memory.
Example	<property name="OUT_ONLY" value="true"/>

Name	ERROR_CODE
Possible Values	string
Default Behavior	none
Scope	synapse
Description	Use this property to set a custom error code on a message which can be later processed by a Synapse fault handler. If the Synapse encounters an error during mediation or routing, this property will be automatically populated.
Example	<property name="ERROR_CODE" value="100100"/>

Name	ERROR_MESSAGE
Possible Values	string
Default Behavior	none
Scope	synapse
Description	Use this property to set a custom error message on a message which can be later processed by a Synapse fault handler. If the Synapse encounters an error during mediation or routing, this property will be automatically populated.
Example	<log level="custom"> <property name="Cause" expression="get-property('ERROR_MESSAGE')"/> </log>

Name	ERROR_DETAIL
Possible Values	string
Default Behavior	none
Scope	synapse
Description	Use this property to set the exception stacktrace in case of an error. If the ESB encounters an error during mediation or routing, this property will be automatically populated.
Example	<log level="custom"> <property name="Trace" expression="get-property('ERROR_DETAIL')"/> </log>

Name	ERROR_EXCEPTION
Possible Values	java.lang.Exception
Default Behavior	none
Scope	synapse
Description	Contains the actual exception thrown in case of a runtime error.

Name	TRANSPORT_HEADERS
Possible Values	java.util.Map
Default Behavior	Populated with the transport headers of the incoming request.
Scope	axis2
Description	Contains the map of transport headers. Automatically populated. Individual values of this map can be accessed using the property mediator in the transport scope.
Example	<property name="TRANSPORT_HEADERS" action="remove" scope="axis2"/>

Name	messageType
Possible Values	string
Default Behavior	Content type of incoming request.
Scope	axis2
Description	Message formatter is selected based on this property. This property should have the content type, for example, text/xml, application/xml.
Example	<property name="messageType" value="text/xml" scope="axis2"/>

Name	ContentType
Possible Values	string
Default Behavior	Value of the Content-type header of the incoming request.
Scope	axis2
Description	Message builder is selected based on this property. This property should specify the content type.
Example	<property name="ContentType" value="text/xml" scope="axis2"/>

Name	disableAddressingForOutMessages
Possible Values	"true", "false"
Default Behavior	false
Scope	axis2
Description	Set this property to "true" if you do not want the ESB to add WS-Addressing headers to outgoing messages. This property can affect messages sent to backend services as well as the responses routed back to clients.
Example	<property name="disableAddressingForOutMessages" value="true" scope="axis2"/>

Name	transportNonBlocking
Possible Values	"true", "false"
Default Behavior	true
Scope	axis2
Description	By default Axis2 will spawn a new thread to handle each outgoing message. To change this behavior remove this property from the message. Removal of this property could be vital when queuing transports like JMS are involved.
Example	<property name="transportNonBlocking" action="remove" scope="axis2" value="true"/>

Name	ClientApiNonBlocking
Possible Values	"true", "false"
Default Behavior	true
Scope	axis2
Description	By default, Axis2 spawns a new thread to handle each outgoing message. This property holds the primary thread until a VFS proxy writes to a VFS endpoint. You need to remove this property from the message to change this behavior when queuing transports like JMS are involved.
Example	<property name="ClientApiNonBlocking" action="remove" scope="axis2"/>

Name	endpoint.operation
Possible Values	string
Default Behavior	none
Scope	synapse
Description	If this property is set, endpoint statistics will be calculated for the specified operation.
Example	<property name="endpoint.operation" scope="axis2" value="OperationName"/>

Name	TRANSPORT_IN_NAME
Scope	synapse
Description	Mediation logic can read incoming transport name using this property (since WSO2 ESB 4.7.0)
Example	<log level="custom"> <property name="INCOMING_TRANSPORT" expression="get-property('TRANSPORT_IN_NAME')"/> </log>

Name	preserveProcessedHeaders
Possible Values	"true", "false"
Default Behavior	Preserving SOAP headers
Scope	synapse(default)
Description	If we set this property to 'true', synapse tries to preserve the SOAP header of incoming requests. Else, by default synapse removes the soap headers.
Example	<property name="preserveProcessedHeaders" value="true" scope="default"/>

Name	SERVER_IP
Possible Values	IP address or hostname of the ESB host
Default Behavior	Set automatically by the mediation engine upon startup
Scope	synapse