7.1

XML Splitter Action Task Properties
XML Splitter action tasks use the XSLT language to split XML data files into multiple XML data files that are passed to sub-
sequent tasks in the process. The XML splitter includes options to add a new root node within the generated files, as well as to
change the original file’s encoding to UTF8. Note that the XML Splitter cannot process files larger than 30 megabytes.
XML Splitter action task properties are as follows:
General Tab
This tab lets you choose the splitter settings for default PlanetPress Suite Workflow Tools 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 Con-
dition 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 typ-
ically 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 gen-
erated 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 wether 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.
l Refresh XSLT: Once you have made all the required settings using the Standard XML splitter option, click this button
to display the XML code generated by the XML splitter. You can then use the box below to edit the code as required.
l {WATCHTEMPFOLDER} file separator: Use this box to edit the default XML file separator (/).
Alternate XSLT Engine tab
This tab lets you choose the splitter settings for your own XSLT engine. If you want to use the default PlanetPress Suite Work-
flow Tools XSLT engine, click the General tab.
©2010 Objectif Lune Inc - 138 -