Use Mapping Flow design

Use the Palette to add nodes

Edit node properties

Input Business Document structure

Use Specific Objects

Mapping Flows are mapping objects that contain specific instructions on how to route, map, or otherwise handle units of input data.

A Mapping Flow typically contains the following:

  • An input object
  • One or more output objects
  • A Block container to perform mapping of message content or routing
  • Business Documents to hold input and output message data for Mappings
  • Events to detect content and parsing errors

Use the Palette to add nodes

To add a node:

  • Select the node from the palette and drag and drop it to your preferred location.
  • If you want to add a Map or a Business Document, you can drag and drop it from the workspace.

Some additional node actions may be performed after you add the node. For example:

If you add a Map, Mapping Services displays the Map object and adds the input and output Business Documents to the Mapping Flow.

You can add some objects from the workspace also:

  • If you want to add a Map from the palette, drag and drop it to the container of your choice and a wizard opens so that you can select an existing Map from the workspace.
  • In the Palette the nodes are grouped by categories: Conditions, Actions, Advanced and Activities.

The following table illustrates the node icons that you can use to define each type of instruction.

Type of Instruction Associated node icon Details

Condition

Decision condition instruction icon Decision

Switch condition instruction icon Switch

Condition instructions test the content of the input Business Document for certain values. When the software finds the values that you specify, it executes the corresponding Action Instructions.

Action

Map action instruction icon Map

Output action instruction icon Route to

Parse step action instruction icon Parse

Action instructions execute the actions that generate one or more output Business Documents. Add Action instructions directly below the Condition instructions that can trigger them.

Advanced

Loop (advanced) instruction icon Loop

While (advanced) instruction icon While

Step (advanced) instruction icon Set

Exit (advanced) instruction icon Exit

Advanced Instructions handle advanced processing needs:

  • Loop: repeats an instruction a fixed number of times
  • While: repeats an instruction until a specified instruction is false
  • Set: specifies a custom instruction
  • Exit: exits from the Decision Path
Activities

Input

Output

Event activity icon Event

Block activity icon Block

Input and Output objects define the links with the input and output channels.

The Block is a container for all the instructions, except the input, output, event and Business Documents.

Edit node properties

For many of the nodes that you select in the Mapping Flow, the Properties view displays one or more fields where you define, modify, and view the properties of the selected node. For each type of node, the following table describes Properties view displays.

Node The middle pane displays:

Decision icon for condition instruction Decision

While (advanced) instruction icon While

Loop (advanced) instruction icon Loop

Switch condition instruction icon Switch

Parse set (advanced) instruction icon Parse

  • The Expression field, where you can define, modify, and view the Instructions (Condition or Advanced) that a node contains.
  • To enter the expressions in an instruction on separate lines, press the <Enter> key.
  • To view and work with the expression that you are editing in a full screen window, use CTRL+F2.
  • To return from the full screen editing window to the normal view, use CTRL+F2 again.
  • The Comment field where you can specify, modify, and view a description of what the Expression field contains.
  • The Expression field contains the path to the Very Large Object field in the input Business Document that will be parsed in the given structure as output. If no valid output message (according to the Business Document definition) can be generated, an error message is displayed. If an incompatible data is found, the remaining characters are ignored and no error is reported if all mandatory fields are created. If more instances of the Business Document are found, only the first will be parsed (the following characters will be ignored).

Exit (advanced) instruction icon Exit

Nothing

Map action instruction iconMap The name of the relevant Map.

Input Business Document structure

When you select a instruction from a container the input Business Documents of that container are shown in the specific section on the right of the palette.

The Expression field contains the path to the Very Large Object field in the input Business Document that will be parsed in the given structure as output. The Parse step throws an error only if it cannot generate a valid output message (according to the Business document definition).

To use nodes in this tree structure in a Map expression, drag-and-drop them from this pane to the Expression field.

Use Specific Objects

Mapping Flow with Web Service Maps:

  • A Web Service Map can only be added in a Web Service Block
  • Only one Web Service Map can be added in a Web Service Block
  • A Web Service Map always has input and output Business Documents

Related topics

Mapping Flows

Mapping Flow editor usage

Related Links