Skip to main content
Validate connectors perform an XML or message header validation step in order to catch invalid XML or message headers before they cause an error later in the flow.

Key Capabilities

  • XML and message header validation using configurable rules and conditions
  • XPath-based validation for XML content with sample file support for rule creation
  • Data type validation for strings, numbers, and DateTime values
  • Group-based rule organization with complex logical conditions (AND/OR)

Overview

Validate connectors are configured with one or more rules that determine whether input XML or message headers are considered valid. Valid input successfully passes through the connector, while XML files or message headers that fail validation throw an error and are not passed along in the flow. For each configured rule, the connector checks the value from the input XML or message header against the target value to see if it is considered valid. See Rules Tab for details.

Connector Configuration

This section contains all of the configurable connector properties.

Rules Tab

Add and configure rules and groups of rules. Input XML and message headers are considered valid if they conform to all of the configured rules. You can build complex validations by defining individual rules and/or groups of rules. To add a validation rule, click Add Rule or Add Group. When you build your rules, use the dropdowns to make your selections and choose your operator. You can choose from the following:
  • Input XML
    • Value: The value at the XPath being evaluated
    • Data Type: The data type of the value (String, Number, DateTime)
    • Occurrences: The number of times the XPath occurs in the document
  • Message Header
    • Value: The value of the message header being evaluated
    • Data Type: The data type of the value (String, Number, DateTime)
When you select an XPath for a rule, if you have uploaded a sample file, the editor displays a tree representation of the document so you can easily find the XPath you need, as shown in the image below. You can reorder rules and groups. Click the handle handle and drag the object to a new location. Input XML is only considered valid if all validation rules (or groups of rules) are satisfied. If the XPath configured in a rule is not found in the input XML, the validation automatically fails. In other words, if the connector is unable to read a value for a rule’s XPath, the input file does not pass the rule.

Settings Tab

Connector Settings

SettingDescription
Connector IdThe static, unique identifier for the connector.
Connector TypeDisplays the connector name and a description of what it does.
Connector DescriptionAn optional field to provide a free-form description of the connector and its role in the flow.

Advanced Tab

Logging

Settings that govern the creation and storage of logs.

SettingDescription
Log LevelThe verbosity of logs generated by the connector. When you request support, set this to Debug.
Log Subfolder SchemeInstructs the connector to group files in the Logs folder according to the selected interval. The Weekly option (which is the default) instructs the connector to create a new subfolder each week and store all logs for the week in that folder. Leaving this setting blank tells the connector to save all logs directly in the Logs folder. For connectors that process many transactions, using subfolders helps keep logs organized and improves performance.
Log MessagesCheck this to have the log entry for a processed file include a copy of the file itself. If you disable this, you might not be able to download a copy of the file from the Transactions tab.

Other Settings

Miscellaneous

Miscellaneous settings are for specific use cases.

SettingDescription
Other SettingsEnables you to configure hidden connector settings in a semicolon-separated list (for example, setting1=value1;setting2=value2). Normal connector use cases and functionality should not require the use of these settings.

Automation Tab

Settings related to the automatic processing of files by the connector.

Performance

Settings related to the allocation of resources to the connector.

SettingDescription
Max WorkersThe maximum number of worker threads consumed from the threadpool to process files on this connector. If set, this overrides the default setting on the Performance Settings portion of the Advanced Settings page.
Max FilesThe maximum number of files sent by each thread assigned to the connector. If set, this overrides the default setting on the Performance Settings portion of the Advanced Settings page.

Alerts Tab

SLAs Tab