Please enable JavaScript to view this site.

Altova MapForce 2022 Enterprise Edition

MapForce validates mappings automatically, when you click the Output tab to preview the transformation result. You can also validate a mapping explicitly before attempting to preview its result. This helps you identify and correct potential mapping errors and warnings before running the mapping. Note that running a mapping may generate additional runtime errors or warnings depending on the processed data, for example, when values mapped to attributes are overwritten.

 

To validate a mapping explicitly, do one of the following:

 

Click Validate Mapping in the File menu.

Click ic-val-mapping (Validate) in the toolbar.

 

When you validate a mapping, MapForce checks, for example, for unsupported component kinds, incorrect or missing connections. The validation result is then displayed in the Messages window with one of the following status icons:

 

Icon

Meaning

valid_ok

Validation has completed successfully.

validate_wf

Validation has completed with warnings.

validate_bad

Validation has failed.

 

The Messages window may additionally display any of the following message types: information messages, warnings, and errors.

 

Icon

Meaning

validator_info

Indicates an information message. Information messages do not stop the mapping execution.

validator_warning

Indicates a warning message. Warnings do not stop the mapping execution. They may be generated, for example, when you do not create connections to some mandatory input connectors. In such cases, the output will still be generated for those components where valid connections exist.

validator_error

Indicates an error. When an error occurs, the mapping execution fails, and no output is generated. The preview of the XSLT or XQuery code is not possible.

 

To highlight the component or structure which triggered the information, warning, or error message, click the underlined text in the Messages window.

 

For components that transform data (e.g., functions or variables), validation works as follows:

 

If a mandatory input connector is not connected, an error message is generated, and the transformation is stopped.

If an output connector is not connected, a warning is generated, and the transformation process continues. The component, which has triggered the warning, and its data are ignored and not mapped to the target document.

 

To display the result of each validation in an individual tab, click the numbered tabs available on the left side of the Messages window. This may be useful, for example, if you work with multiple mapping files simultaneously.

 

Other buttons in the Messages window enable you to take the following actions:

 

To filter the message by types (e.g., to show only errors or warnings);

To move up or down through the entries;

To copy the message text to the clipboard;

To find a specific text in the window;

To clear the Messages window.

 

© 2015-2021 Altova GmbH