7.3

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.
l CSVEmulation Group
l Add header to each output file:This option should only be checked if you are using CSVemulation, and
will copy the first line of your data file as the first line of each split file aftewards. This is useful only if your first
line is a Header line that contains your field names.
On Error Tab
The On Error Tab is common to all tasks. Details can be found on "Task Properties Dialog" (page 54).
Generic Splitter
The Generic splitter is a legacy task which is kept for backwards compatibility purpose. In previous versions of PlanetPress
Workflow, it was the only splitter available. While this splitter seems to have more options than the other ones, this is only
because it contains combined features from these other splitters.
The Generic splitter, while seemingly more feature-rich, is slower than the other splitters by an order of magnitude.
Whenever encountering the Generic splitter, it is always recommended to replace it with a more appropriate splitter
instead.
Generic Splitter action task properties are as follows:
General Tab
l Split data file on: Use this box to choose the item on which top split the file. The options available depend on
whether or not the Use emulation box is checked (see below).
l Use emulation: Check to emulate the data before splitting the file. This lets you split the file on a word, a word
change, a page number, a database field value or a database field change. When this option is not checked, you can
only split the file on a form feed, a specific number of lines, or a chain of characters. See below for detailed information
on any of these splitting methods.
l A word :If you choose “A word” in the Split data file on list box (the Use emulation option must be selected), the fol-
lowing boxes are displayed.
l Word: Enter the string of characters to search for as the splitting criteria. In this variable property box, you may enter
static characters, variables, job information elements or any combination of these.
l Get: Click to get a static string of characters from the sample data file. If you use this button, the coordinates of the
data you will select will be added to the Word is between lines and Word is between columns groups below.
l Word is between lines group
l From and To: Enter a vertical search region defined as starting from a given line and ending at a given line. If
you enter 1 in the From box and 1 in the To box, the Generic Splitter will search for the string of characters
entered above only in the first line of every page. If you enter 1 in the From box and 10 in the To box, the
Generic Splitter will search in the ten first lines of every page. Note that the actual search region is a com-
bination of the vertical and horizontal search regions.
l Word is between columns group
l From and To: Enter a horizontal search region defined as starting from a given column and ending at a given
column. If you enter 1 in the From box and 5 in the To box, the Generic Splitter will search for the string of char-
acters only in the first five column (five first characters of every line selected above).
l Consider case: Select to force the Generic Splitter to match the character casing of the string of characters
entered above with the characters found in the file. If this option is selected, “DAY” and “Day” will not be con-
sidered as matching the search string “day”.
©2010 Objectif Lune Inc - 146 -