Handling an IllegalDataException for invalid XML during serialization

When you convert a string that contains ASCII control characters to XML, you receive an IllegalDataException during serialization. You can add a configurable property the appropriate 100Custom.xml file in your topology to automatically make strings XML-compliant.

About this task

When you enter XML characters into a form, coach, or a JavaScript API, the tw.system.serializer.toXml JavaScript API takes the input as a TWObject, parses it, and converts it into XML. If the TWObject contains a string with invalid XML characters, such as control characters 0x01 or 0x02, it raises an IllegalDataException. To have IBM® Business Process Manager automatically correct the XML code, you can add a configuration flag <autocorrect-xml> in the appropriate 100Custom.xml file in your topology that automatically removes invalid characters in a string input and makes it XML-compliant.

Procedure

Stop the server for IBM Process Server or IBM Process Center.
Locate each 100Custom.xml file in your topology. For more information about the location of the 100Custom.xml files that must be updated, see the topic Location of configuration files.

Add the following code to each 100Custom.xml file:

<server>
    <autocorrect-xml merge="replace">true</autocorrect-xml>
</server>

Save your changes to each 100Custom.xml file.
Start the server for Process Server or Process Center.