IBM Format of XML-type ruleset parameters in SOAP messages with MTDS - United States XSD; schema; SOAP; web service TECHNOTE (FAQ)

QUESTION
 How to format the value of an XML-type ruleset parameter in the SOAP request to a Monitored Transparent Decision Service (MTDS) ? 

CAUSE
As mentioned in the documentation for MTDS, XML parameters are represented by a String in the WSDL file.

ANSWER
The value of the parameter is the XML data corresponding to your input parameter XSD, either passed in a CDATA section or by escaping the XML special characters (replacing <, >, ", ' and & with &lt;, &gt;, &quot;, &apos; and &amp;). 

For more information on transparent decision services, refer to section "Rule Execution Server > Introducing Rule Execution Server > Rule Execution Server basics > Transparent decision services and rule execution" of the JRules V7.1 documentation [http://publib.boulder.ibm.com/infocenter/brjrules/v7r1/index.jsp?topic=/com.ibm.websphere.ilog.jrules.doc/Content/Business_Rules/Documentation/_pubskel/JRules/ps_JRules_Global926.html].

RELATED INFORMATION
 JRules V7.0 doc on transparent decision services [http://publib.boulder.ibm.com/infocenter/brjrules/v7r0m3/topic/com.ibm.websphere.ilog.jrules.doc/Content/Business_Rules/Documentation/_pubskel/JRules/ps_JRules_Global801.html]
WODM V7.5 doc on transparent decision services [http://publib.boulder.ibm.com/infocenter/dmanager/v7r5/topic/com.ibm.dserver.res/Content/Business_Rules/_pubskel/Infocenter_Primary/ps_DS_Rule_Execution_Server1460.html]





Cross reference information Segment Product Component Platform Version Edition Business Integration IBM Operational Decision Manager Platform Independent 8.5, 8.0, 7.5
javax.xml.bind.UnmarshalException org.xml.sax.SAXParseException: The reference to entity must end with the ; delimiter. 

After an upgrade from JRules to ODM we are receiving errors because of an ampersand in our data. This used to work before.

Caused by: javax.xml.bind.UnmarshalException
- with linked exception: [org.xml.sax.SAXParseException: The reference to entity "NIGHT" must end with the ; delimiter.
The value of the parameter is the XML data corresponding to your input parameter XSD, either passed in a CDATA section or by escaping the XML special characters (replacing <, >, ", ' and & with &lt;, &gt;, &quot;, &apos; and &amp;).