Multiple Conditions step properties

The Multiple Conditions step contains a number of Case conditions (one to start with) and a Default, to be executed when none of the other cases apply. Cases are executed from left to right. For more information see Steps.

The properties described below become visible in the Step properties pane when the Multiple Conditions step is selected in the Steps pane.

Description

This subsection is collapsed by default in the interface, to give more screen space to other important parts.

Name: The name of the step. This name will be displayed on top of the step's icon in the Steps pane.

Comments: The text entered here will be displayed in the tooltip that appears when hovering over the step in the Steps pane.

Condition

Left operand, Right operand

The Left and right operand can be Based on:

  • Position: The data in the specified position for the comparison.

    • Left (Txt and PDF only): The start position for the data selection. Note that conditions are done on the current line, either the current cursor position, or the current line in a Repeat step.

    • Right (Txt and PDF only): The end position for the data selection.

    • Height (Txt and PDF only): The height of the selection box.

    • Column (CSV and Database only): Drop-down listing all fields in the Data Sample, of which the value will be used.

    • Top offset: The vertical offset from the current pointer location in the Data Sample (Viewer).

    • XPath (XML only): The path to the XML field that is extracted.

    • JsonPath (JSON only): The path to the JSON element that is extracted. (See: JsonPath.)

    • Use Selection: Click to use the value of the current data selection for the extraction.

    • Trim: Select to trim empty characters at the beginning or the end of the field.

  • Value: A specified static text value.

    • Value: The text value to use in the comparison.

    • Use selected text: Uses the text in the current data selection as the Value. If multiple lines or elements are selected, only the first one is used.

  • Field: The contents of a specific field in the Extracted Record.

    • Field: The Extracted Record field to use in the comparison.

  • JavaScript: The result of a JavaScript Expression.

    • Expression: The JavaScript line that is evaluated. Note that the last value attribution to a variable is the one used as a result of the expression. See also: DataMapper Scripts API.

    • Use JavaScript Editor: Click to display the Edit Script dialog (see Using scripts in the DataMapper).

    • Use selected text: Inserts the text in the current data selection in the JavaScript Expression. If multiple lines or elements are selected, only the first one is used.

  • Data Property: The value of a data-level property set in the Preprocessor step (see Steps).

  • Record Property: One of the local variables that you can create and that are reset for each document as opposed to data variables that are global because they are initialized only once at the beginning of each job.

  • Automation Property: The current value of a Document-level property set in the Preprocessor step (see Steps).

  • Extractor Property: The value of an internal extractor variable:

    • Counter: The value of the current counter iteration in a Repeat step.

    • Vertical Position: The current vertical position on the page, either in Measure (PDF) or Line (Text and CSV).

Condition

The Condition drop-down displays the cases in list form. Three buttons are available next to the list:

  • Add case: Click to add a new case to the step. It will be placed next to any existing cases.

  • Remove case: Delete the currently selected case.

  • Order Cases: Under the Name column, select a case, then click one of the buttons on the right (Delete, Move Up, Move Down) to delete or change the order of the cases in the list.

Operators

Case conditions are made by comparison of the two operands, left and right, using a specific Operator.  

  • is equal to: The two specified value are identical for the condition to be True.

  • contains: The first specified value contains the second one for the condition to be True.

  • is less than: The first specified value is smaller, numerically, than the second value for the condition to be True.

  • is greater than: The first specified value is larger, numerically, than the second value for the condition to be True.

  • is empty: The first specified value is empty. With this operator, there is no second value.

  • Invert condition: Inverts the result of the condition. For instance, is empty becomes is not empty.