7.4

l Specific word: Enter the word to use as the splitting criteria. In this variable property box, you may enter
static characters, variables, job information elements or any combination of these. You may also use the Get
Data button to get a static string of characters from the sample data file. If you use this option, the coordinates
of the data you will select will be added to the Left, Right, Top and Bottom boxes below.
l Left: Enter a value corresponding to the left coordinate on which the splitter must start searching for the region.
l Right: Enter a value corresponding to the right coordinate on which the splitter must start searching for the
region.
l Top: Enter a value corresponding to the top coordinate on which the splitter must start searching for the region.
l Bottom: Enter a value corresponding to the bottom coordinate on which the splitter must start searching for
the region.
l Match case: Select to force the splitter to match the character casing. Note that this setting applies both to the
On region change and Specific word options. If this option is selected, “DAY” and “Day” will not be considered as
matching the search string “day”.
l Trim selection: Select to force the splitter to strip empty trailing characters. When this option is not selected,
blank trailing characters, if any, are considered in the matching process, so the word “DAY” will not be con-
sidered as matching the word “DAY”. Note that this setting applies only to the On region change option.
l Where to split: By default, the task splits the file at the beginning of the line on which the condition is met (the
default value is 0). If you want the task to split the file a certain number of lines before or after that line, enter a
value other than 0 in this box. Enter 1, for example, to split the file at the beginning of the line that precedes the
line on which the condition is met.
l Before: If you entered a value other than 0 in the Where to split box, select this option if you want to split the
file a given number of lines before the line on which the condition is met.
l After: If you entered a value other than 0 in the Where to split box, select this option if you want to split the file
a given number of lines after the line on which the condition is met.
l When condition is found: By default, the task splits the file every time the condition is met (the default
value is 1). If you want the task to split the file only when the condition has been met twice, for example, enter
the number 2 in this box.
On Error Tab
The On Error Tab is common to all tasks. Details can be found on Task Properties Dialog.
If storing the message or ID, if they are store in a jobinfo they will be available in any error handling process where errors are
being forwarded. In all cases, if your process continues after the error, the contents of the variables selected in this window
will be available for the rest of your process, or whenever they are overwritten.
Common Errors
Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are
related more to the system than to PlanetPress itself. Some examples would be W3813, W3830, W3991, W4005. These cor-
respond to issues such as not having any space to write files, permission errors on folders or files, etc.
XML Splitter
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.
Input
A XML Emulation data file.