Debugging mappings

Before you start

To complete this task, you must have completed the following tasks:

This topic describes how to debug a flow with mappings.

To check the mapping routines:

  1. Switch to the Debug perspective.
  2. In the Debug view, click the Step into Source Code Step into code icon on the toolbar (or right-click on the flow stack frame and then click Step into Step Into). The Message Mapping editor opens with the mapping routine highlighted in both the Mapping editor and the Outline view.
  3. To use breakpoints on mapping lines:
    1. In the Message Mapping Editor, select the line for the mapping command you want to use, right-click on the space beside it and select from the menu to add or disable a breakpoint. (Alternatively double-click the same space to add or remove a breakpoint). You cannot set a breakpoint on a comment line or a blank line.
    2. Select from the menu to create, delete, or restrict the breakpoint, in a similar way to normal debugger breakpoints, as described in Working with breakpoints.
  4. Check the mapping routines by performing the various stepping actions (step into, step over, and step return). While you are doing this, in the Debug view, the stack frame shows the list of mapping commands and the current command. The Variables view shows your user-defined mapping variables, along with the input message (that is, the Debug Message). You can alter the user-defined variables.

When you have finished debugging the mapping, the message flow ends in the usual manner.

Related concepts
Flow debugger overview
Message Mapping editor
Related tasks
Debugging a message flow
Working with breakpoints
Stepping into source code
Stepping over source code
Stepping out of source code
Related reference
Flow debugger shortcuts
Flow debugger icons and symbols