Debug Breakpoints

Breakpoints and Conditional Breakpoints are used during the Debug process to set stopping points for Map processing. If you have inserted Breakpoints into the Map for Debug, the Breakpoints tab displays a row for each Breakpoint. See Debugging Maps for additional information.

Rows contain the following information:

Field	Definition
Active	Indicates whether the Breakpoint is active or inactive. Inactive Breakpoints are ignored during the debug process. Use the Active link at the top of the column to toggle all Breakpoints to active or inactive. Use individual check boxes to make single Breakpoints active or inactive.
Name	Name of the Breakpoint, which is composed of the name of the data source, the Label of the Block, and number. Number is only appended if the Breakpoint name is a duplicate. If you change a Block Label after a Breakpoint has been set, the label does not update on the Breakpoints tab. Toggle the Breakpoint off and back on to get the new name or exit the Map, go back in, and reset the Breakpoint.
Condition	Condition set on the Breakpoint, such as “Field Name (<,>,=,>=,<=,!=) Value”. If a Breakpoint has a condition, debug only stops execution if the condition is true, otherwise the Breakpoint is ignored. Condition is optional.
Hit Count	Increments each time the Breakpoint is reached. When a Breakpoint is inside a For Each Child Block, the count is incremented once for each child record. Can be used as a condition in Conditional Breakpoints to stop debug after the selected number of iterations.
Icons
	Active Breakpoint is not Conditional
	Active Conditional Breakpoint
	Inactive Conditional Breakpoint
	Inactive unConditional Breakpoint

Using Breakpoints

• Set a Breakpoint: Select the Block, then from the Gear menu select Toggle Breakpoint.
• Delete a single Breakpoint: Select the Block, then from the Gear menu select Toggle Breakpoint, or select the Breakpoint in the Breakpoints tab and from the Gear menu select Delete Breakpoint.
• Delete all Breakpoints: Select the Block, then from the Gear menu select Delete All Break Points.
  • Debug always stops after the first Block. You must select Continue to go to the first active Breakpoint with no condition or whose conditions are true.
  • The debug run stops before the Block, but after the inputs have been processed.
  • When debug stops at a Breakpoint, select Continue or Next to go to the next Block, next Breakpoint, or the end of the Map.
  • All Breakpoints are deleted when the Map is closed.

Using Conditional Breakpoints

• Review Conditional Breakpoints using the Breakpoints tab.
• Debug only stops at a Conditional Breakpoint if the specified condition is true.
• Add a Conditional Breakpoint: Select the Block, then from the Gear menu select Edit Breakpoint. The Edit Breakpoint dialog contains the following fields:
  • Block Label — View only field containing the user-specified label for the Block, not the Block name.
  • Field name — Contents of this datastore field are compared to the Field Value to determine whether debug should stop at this point. Select the required field name from the drop-down list.
  • Comparison — Parameter that determines how the data is compared. Options include: equals, is not equal to, is less than, is less than or equal to, is greater than, is greater than or equal to, is null, or is not null.
  • Field Value — Value of the field that satisfies the condition and triggers debug to stop at the Breakpoint.If the comparison selected is either "is null", or "is not null", the Field Value field is disabled because no other information is required.

    Important: Strings entered in the Field Value field must NOT use beginning and ending quotes, such as "Maple Street".

    Important: If the data type of the value entered does not match the data type of the field in the source, the debug process does not stop at the Breakpoint.

    For example, if your condition is Company.name equals 8 and Company.name is a string, the process does not stop at the Breakpoint because the value is an integer.

  • Is Active — Select this checkbox to make the Breakpoint active and for debug to stop at the Breakpoint during the execution of the Map.

Set Conditional Breakpoint

Related Topics

Debugging Maps

Debug Data

Debug Results

Debug Errors

Debug History

Executing Maps In Debug Mode