2022.2

Task properties
General Tab
l
Source encoding: Select the current data encoding. Note that the source encoding is not selec-
ted automatically and you must therefore select the proper encoding from this list in order for the
conversion process to be performed successfully.
l
Target encoding: Select the encoding to which you want the data to be converted.
l
Include target encoding signature: This option is only available when converting to UTF-8
(Windows code page 65001) or UCS-4 (code page 12000 or 12001). Select to include the char-
acter encoding signature—also known as the byte order mark—at the beginning of the target
string.
l
Default character on translation: You may enter a character to be used to replace all those
characters that cannot be found in the source encoding. If you leave this box empty, they will be
simply stripped from the data, so you may consider using a space as a place holder for uniden-
tified characters.
Miscellaneous Tab
The Miscellaneous tab is common to all tasks.
Check the option Use as step description to display the text next to the icon of the plugin in the Pro-
cess area.
XML/JSON Conversion
The XML/JSON Action task converts an XML job file to JSON or a JSON job file to XML.
This task makes parsing XML/JSON files much simpler in a JavaScript environment and also allows
processes to natively send JSON to a Connect template or data mapping configuration.
Input
The current job file.
Processing
The current job file is converted from XML to JSON or from JSON to XML. When converting from JSON
to XML, the encoding of the resulting XML file is always set to UTF-8 (which is the default format for
JSON).
The converted job file gets the appropriate extension (.JSON or .XML).
If the current job file isn't JSON or XML (depending on the type of conversion requested), or if the con-
version fails for any reason, the task raises an error and the current job file and metadata remain
unchanged.
Page 405