Using advanced mapping

To use advanced mapping by importing or editing XSLT:

  1. Click the XSLT Editor tab of the Mapper.
    If you have previously created a graphical mapping, the Mapper generates XSLT 2.0 based on the mapping connections and functions you have created. Lines in the generated hierarchical XSLT structure are numbered and more advanced features are available:
    • Syntax highlighting.
    • Option to validate the XSLT code and see the validation error.
    • Error line highlighting and error details are available when the validation fails.
    • Version comparison tool that visualizes differences in the XSLT code in two mapping version. You can copy changes from one to the other.
      • Toggle button to turn the comparison tool on or off.
      • Drop-down menu to select a version or to compare against user’s custom code.
      • Side-by-side editor to compare XSLT code.
      • Right-side editor is read-only when an existing version is selected.
      • Buttons for finding previous and next difference.
      • Copy differences from the right to the left editor by clicking the arrows where a difference is detected.
    • Comparison tool to evaluate the differences in the XSLT code between two mapping versions.
    • Code formatting of well-formed code.
    • Autocomplete, with predefined set of XSLT keywords and support for custom completions: press Ctrl + Space.
    • Search function: press Ctrl + F.
      • Case-sensitive search.
      • Regular expression search.
      • Whole word search.
      • Highlight all items found.
      • Browse the page for the found elements.
    • Find and Replace function: press Ctrl+F twice.

    The same code visualization and search features are available in the Testing tab and in XSLT editing sections of the Function Editor. Limited options are available for non-editable fields.

  2. Edit the XSLT.
    For details, see Editing XSLT.

    Alternatively, import XSLT that is created by a third party tool to manually edit the XSLT.

    A header comment is inserted into the newly created or modified XSLT code while the code is in the draft state. These changes and modifications are reflected in the header comment:

    • Changes that are made in the Modeler.
    • Modification of these mapping properties:
      • Name
      • Description
      • Version number
      • Creation author, date and time
      • Last modification author, date and time
      • Input and output documents
    • ION version number, from which the XSLT code was generated