XML Action Properties

The Action Step can run multiple specific actions one after the other in order. More actions will be available in the future.

Actions

This section lists all actions executed by the step, and their types:

• Name: A name by which to refer to the action. This name has no impact on functionality.
• Type of action:
• • Set property: Sets the value of a Source Record Property which was created in the Preprocessor Step.
  • Run JavaScript: Runs a JavaScript expression, giving much more flexibility over the Extractor process.

Set Property

• Property: Displays a list of Source Record Properties set in the Preprocessor Step.
• Type: Displays the type of the Source Record Property. Read only field.
Based on: Determines the origin of the data.
• JavaScript: The result of the JavaScript Expression written below the drop-down will be the value of the extracted field. If the expression contains multiple lines, the last value attribution (variable = "value";) will be the value. See JavaScript API.
• Use JavaScript Editor: Click to display the Edit Script dialog.
• Location: The contents of the data selection set below will be the value of the extracted field. The data selection settings are different depending on the data sample type.
• XML
• XPath: The path to the XML field that is extracted.
• Use selection: Click to use the value of the field currently selected in the Data Viewer for the XPath.
• Trim: Select to trim empty characters at the beginning or the end of the field.
• CSV and Database
• Field: Dropdown listing all fields in the Data Sample, of which the value will be used.
• Top offset: The offset from the current pointer location in the Data Sample.
• Use selection: Click to use the value of the current selected field for the extraction.
  If the selection contains multiple lines, only the first line is selected.
• Trim: Select to trim empty characters at the beginning or the end of the field.
• Text
• Left: Defines the start of the data selection to extract.
• Right: Defines the end of the data selection to extract.
• Top offset: The offset from the current pointer location in the Data Sample.
• Use selection: Click to use the value of the current data selection for the extraction.
  If the selection contains multiple lines, only the first line is selected.
• Trim: Select to trim empty characters at the beginning or the end of the field.
• PDF
• Left: Defines the start of the data selection to extract.
• Right: Defines the end of the data selection to extract.
• Top offset: The offset from the current pointer location in the Data Sample.
• Use selection: Click to use the value of the current data selection for the extraction.
  If the selection contains multiple lines, only the first line is selected.
• Trim: Select to trim empty characters at the beginning or the end of the field.

Run JavaScript

• JS Expression: The JavaScript expression to run.
• Use JavaScript Editor: Click to display the Script Editor dialog.

Running a JavaScript expression offers many possibilities, for example:

• Setting Properties and Record Field values using advanced expressions
• Do complex mathematical operations and calculations
• More features to come in future versions.

For more information, see the JavaScript in DataMapper section.