Debugging Maps

Use the Debug tool on the Map workspace to execute a Map and watch the results to locate logic and record errors. Execute the Map either, Block by Block, in series of Blocks based on the location of breakpoints that you specify, or enable the Break On Record Error option to execute Blocks in sequence until a record error is found. See Debug Errors for more information.

Unlike the Preview feature, Debug mode executes the selected Map using the specified Connections. Debug modifies your target data, and the execution results display in your Execution History. When breakpoints are added to the Map the debug process moves from one breakpoint to the next across multiple Blocks instead of executing the Map one Block at a time. Best practice is to only use Debug Mode in a test environment.

Tip: Debug follows the logic and flow of your Map as though it were executing normally. For example, for If/Else Blocks, Debug processes the If/Else logic and then correctly processes either the Block following the If or the Block following Else. For more information, see If/Else Block.

Note: Best practices is not to modify a Map while in Debug Mode. The Map is loaded in the Debug session when you enable Debug Mode and any changes to the Map are not reflected in Debug results. To include Map changes in Debug results, exit Debug Mode, modify and save the Map, and return to Debug Mode.

Debugging Maps is not supported if your Map:

Requirements

To start Debug Mode for a Map:

Note: When you select Debug Mode, the Connection panel on the left is hidden and the Properties panel on the right is replaced with a set of Tabs that display information during the Debug process.

Debug Commands

To display Debug commands, open the Map to debug and select Debug Mode. To end Debug Mode, select Exit Debug Mode or Stop.

Debug Tabs

Debug tabs display information about the records being processed based on the Blocks in the Map above and below the Debug arrow. Tabs include: 

Notes

Related Topics

Executing Maps In Debug Mode

Debug Data

Debug Results

Debug Errors

Debug Breakpoints

Debug History

Defining An Event Message Map

Defining An Event Request/Reply Map

Defining An Integration Map