Managing Mappings

A mapping correlates data from the schema in the context panel with a data component in the message panel.

Procedure

  • You can create and manage mappings using several functions:
    Function Procedure
    Creating a mapping
    1. Drag and drop data components from the left-hand panel to the right-hand panel.
    2. The appropriate XPath expression is displayed in the XPath Expression field.
    Adding functions or constants to an XPath expression Use the tabs at the bottom of the context panel (described in Data Function Tabs).
    Opening a larger window in which to view or edit an XPath statement Click an expression in the XPath Expression field, or click the Show Edit Tab button on the toolbar.
    • Lines appear between data components that are mapped to each other. The lines are blue when both components are visible, but the lines turn into a dashed green line when one or more mapped components are collapsed into its parent in the schema tree.
    • Data components in the message panel are initially displayed in italics. Italic text indicates that the components are hints to the potential mappings you can create.
    • Once you create a mapping for a data component, the hint changes from italics to non-italic font. Non-italic font indicates that the mapping is now an XSLT statement that transforms the data into the specified component. You can change a hint into a statement without performing a mapping by selecting a component in a message schema and dragging it past the dividing line between the left and right panels.
    • Data components on the right-hand side of a mapping can be either black or red. If the component is black, the XSLT statement for the component is valid and complete. If the component is red, that indicates the statement for the component is an error and must be repaired as described in the next section.