The XQuery Mapper toolbar is located above the XQuery Mapper panes. The toolbar contains various tools to work with the graphical mapper. Figure shows the XQuery Mapper toolbar.

The XQuery Mapper toolbar contains the following tools:

• Function Selector: The function selector box is identified by a green icon with the letter f on it. You can use the Function Selector to select the function to display in the source pane. This is useful if your XQuery map contains multiple functions.

• Add New Function: The Add New Function button is identified by the green plus (+) sign. Use Add New Function to add a new function to the XQuery map file.

• Rename Function: The Rename Function button is to the right of the Add New Function button. Use the Rename Function button to rename a function in the XQuery map file.

• Delete Function: The Delete Function is identified by a red cross (X) sign. Use Delete Function to delete a function from the XQuery map file.

• Import Library Module: The Import Library Module button is to the right of the Delete Function button. Use Import Library Module to import a library XQuery function into the map. You must specify the library module files to be imported.

• Mapping Mode: The XQuery mapper can use different mapping modes. These modes affect the XQuery expressions created when the user drags and drops a line from a source node to a target node. The next three buttons are used to select the corresponding mapping mode:

  • Value Mapping: Constructs target XML elements and attributes from the input source, and copies the input source values, using XML constructors. For example:

    <ID>{fn:data($pParam1/ID)}</ID>

    The above code creates the ID element in the target from the ID element in the input source parameter.

    Value mapping is the default mapping mode.

  • Overwrite Mapping: The XML elements from the input source parameters are copied to the result sequence. Any existing mapping are replaced with the new mapping. For example:

    {

    $pParam1/Items

    }

    The above code copies the Items subtree, together with its child elements and attributes, to the target tree.

  • Append Mapping: This mode works like overwrite mapping, except that any existing mappings are not overwritten. New additional mapping are created.

  See Using the XQuery Mapper for more information on using the mapping modes.

• Show/Hide Target Type Differences: Use the Show/Hide Target Type Differences button to manage the visibility of XML elements and attributes in the right target tree. You can choose to hide elements and attributes that haven't been mapped yet.

• Search: Use the Search field to search for elements, attributes, data types, and so on in the source and target trees. Use the Up and down arrows to look for the next and previous items respectively.