8.4

Properties
General Tab
This tab lets you choose the splitter settings for default PlanetPress Workflow XSLT engine. If you want to
use your own XSLT engine, click the Alternate XSLT Engine tab.
l Split method: Use this box only if you want to edit the standard XSLT script that will be used to split the
XML file. First use the Standard XML splitter option to define the standard settings. Then, to change
the standard XSLT script, select Advanced XML splitter and edit the script as required.
l Standard XML splitter options
The following options are only displayed when the Standard XML splitter option is selected in the Split
method box.
l Condition node path: In the tree view, select the XML node to consider to determine when to split
the file. To indicate whether you want the file to be split whenever this node is encountered or
whenever the information in this node changes, see the Condition group below.
l Condition group: Use this group to indicate whether you want the file to be split whenever this
node is encountered or whenever the information in this node changes.
l When condition node is found: Select if you want the file to be split whenever the node selected
in the Condition node path box is encountered.
l When condition node content changes: Select if you want the file to be split whenever the
information stored in node selected in the Condition node path box changes. When this option is
selected, the split files typically contain more information (all the orders for a given customer, for
example).
l New file root structure group: Use this group to tailor the structure of the generated XML files.
l Keep XML structure: Select if you want the generated files to have the exact same structure as
the original XML file (all the way to the root node).
l Add new root node: Select this option and enter a root node name in the box to the right, if you
want the generated files to have a structure that begins with a new root name and that then goes
directly to the node on which the file was split, as indicated in the Split on node box below.
l Encoding group: This group lets you indicate whether you want the splitter to use the file’s own
encoding or the universal encoding UTF8 to process the file. Note that if the file contains no
indication as to which encoding should be used, the default system encoding will be used. This
may result in errors being generated or split files that contain bad data. Using the UTF8 encoding
can prevent such errors.
l Use UTF8 encoding: Select if you want to use the UTF8 encoding to process the file.
l Use file’s encoding: Select if you want to use the XML file’s own encoding to process the file.
l Advanced XML splitter options The following options and buttons are only displayed when the
Advanced XML splitter option is selected in the Split method box. Note that you should not use this
option before you have completed all the required settings using the Standard XML splitter option.