8.4

l To compare two strings. As with the test above, this test can also be used to search for a string in a
given location. The difference with this test is that it gives you comparison options. Using the
“Contains” operator, you can test the presence of the string “Gold member” at a given location in the
job file (using a data selection), but the other operators can be used to test whether or not the first
string is equal to the second one, whether it is equal or lower than the second one, etc.
The logic of text conditions can sometimes be tricky, especially if it includes variable strings, so you should
test it thoroughly.
Properties
General tab
l String: If you want to test the presence of a given string at a given location, enter the string in this box. If
you want to compare two strings or perform a numeric comparison, enter the first string in this box.
Note that you can enter either a static string, a variable or a data selection in this box. If you enter a
variable, PlanetPress Workflow will retrieve the string from the variable before performing the
comparison. If you enter a data selection, PlanetPress Workflow will search the job file and retrieve the
string found at the referenced location before performing the comparison.
l Operator: Select the desired operator. Note that neither the “Is found” nor the “Is not found” operator
can be used to test XML data.
l Convert data to uppercase before comparison: This option is only displayed when either “Is found” or
“Is not found” is selected in the Operator box. Select to prompt PlanetPress Workflow to convert the
string to uppercase before performing the comparison.
l Numeric comparison: This option is not displayed when either “Is found” or “Is not found” is selected in
the Operator box. Select to convert the strings from the String and Comparison string boxes to their
corresponding numeric values before performing the comparison. If you chose an operator that
compares numeric values, you should select this option.
l On numeric error: This option is only available when the Numeric comparison option is selected.
Select the behavior you prefer when PlanetPress Workflow is unable to successfully perform a
numeric comparison. Select ”Return the error”, if you want the Text condition to fail altogether. Select
”Return true”, if you want the condition to be considered True. Select ”Return false”, if you want the
condition to be considered False.
l Location: You can only enter a location when either ”Is found” or ”Is not found” is selected in the
Operator box. If you select “at”, you also have to enter a specific line and column. If you select “on line”,
you have to enter a given line. If you select “in area”, you have to enter a range of lines and columns. If
you select “on the page”, the search area will cover the whole data page (as defined below).