XML File Settings

Delimiters

Delimiters for XML files are related to XML Nodes, or locations in its hierarchy.

Use Root Node: Locks the XML Nodes option to the top-level node. If there is only one top-level node, there will only be one record before the Boundaries are set.
XML Nodes: Displays a list containing all the nodes in the XML file. Selecting a node causes a new page of data to be created every time an instance of this node is encountered.

Boundaries

Record Limit: Defines how many Source Records are displayed in the Data Viewer. To disable the limit, use the value "0".
Condition: Defines the type of rule that defines when a boundary is created, establishing a new record in the Data Sample (called a Source Record).
- On Change: Defines a new Source Record when a specific field under the XML level has a new value.
- - Field: Displays the fields that are under the XML level. The selected one's value determines new Boundaries.
- By Occurrence: Defines a new Source Record on each new instance of the XML level selected in the Delimiters.

Data Samples

The Data Samples box displays all the data sources that have been imported into the data mapping configuration. Right-clicking in the box brings up a control menu:

Add: Used to add a new Data Sample from an external Data Source. The new Data Sample will need to be of the same data type as the current one. For example, you can only add PDF files to a PDF data mapping configuration. In version 1.3 and higher, multiple files can be added simultaneously through the Add dialog.
Remove: Removes the current Data Sample from the data mapping configuration.
Replace: Opens a new Data Sample and replaces it with the contents of a different data source.
Reload: Click to reload the currently selected Data Sample and get any changes that have been made to it.
Set as Active: Activates the selected Data Sample. The active data sample is shown in the Data Viewer after it has gone through the Preprocessor Step as well as the Delimiter and Boundary settings.

External JS Libraries

External JS libraries included in the Settings Pane can add more JavaScript functionality to your data mapping configuration. Any functions included in the JS library will be available in Preprocessor scripts, as well as Action tasks, Post Functions and JavaScript-based extraction steps.

For example let's take the following JavaScript file, for example:

function myAddFunction(p1, p2) {
    return p1 + p2;
};

If this is saved as myFunction.js and imported, then the following would work anywhere in the configuration:

var result = myAddFunction(25, 12); // returns 37!

The External JS Libraries box displays all the libraries that have been imported into the data mapping configuration. Right-clicking in the box brings up a control menu, also available through the buttons on the right:

Add: Used to add a new external library. Opens the standard Open dialog to browse and open the .js file.
Remove: Removes the currently selected library from the data mapping configuration.
Replace: Opens a new library and replaces it with the contents of a different js file.
Reload: Click to reload the currently selected library and get any changes that have been made to it.