Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Debug controls

Updated on December 9, 2021

Use debug controls to manage the flow of steps for testing automations.

You have the following controls to use while testing different environment overrides.

Debug controls
Figure showing debug controls for managing the flow of testing.

Debugging controls often work together with breakpoints. The steps are defined by breakpoints, which subdivide an automation so you can identify the location of any flaws.

Debugging control descriptions

ControlDescription
Step inAdvances to the next step and stops. If the next step is an automation, it runs that automation.
Step overAdvances to the next step and stops. If the next step is an automation, proceeds to the step after the automation.
Step outIf in a called automation, advances to the next step in the calling automation. Otherwise, it just continues.
ContinueResumes testing until another breakpoint is reached.
StopEnds debugging.

During debugging, you can right-click on the automation surface and access a menu of these controls.

Control menu
Figure showing menu of debugging controls available during debug
                        mode.

Using breakpoints to test an automation

Breakpoints subdivide your automations into sections, so you can more easily test functionality and locate issues.

  1. Right-click a link between two automation blocks and select Toggle breakpoint.Result: A red dot displays on the automation link, as in the following figure:
    Breakpoint on an automation link
    A figure showing a simple automation with an active breakpoint
                                between two automation blocks.
  2. Click Test at the top right of the Automation surface.Result: The automation pauses at the first breakpoint and highlights the current step, as shown in the following figure:
    Automation paused at breakpoint
    A figure showing an automation beting tested, and paused at the
                                first breakpoint.
  3. To temporarily turn off a breakpoint, right-click on the breakpoint and select Disable breakpoint.Result: The breakpoint now shows with a red border filled with white. When you test the automation, it skips the disabled breakpoint and moves to the breakpoint in the second step, as shown in the following figure.
    Disabled breakpoint flow
    Figure showing disabled breakpoint in an automation, which moves to
                                the next breakpoint.
  4. To remove a breakpoint, right-click on the breakpoint and click Remove Breakpoint.

Managing breakpoints with debugging tools

Debugging tools help you manage breakpoints in your automations to facilitate the testing process.

Debugging tools are accessed from the Debug menu, shown in the following figure:

Debug menu
Figure showing the Debug menu with Debugging tools highlighted.

Check the Enable checkbox to enable or disable a breakpoint. The following figure shows the Enable checkboxes in the Debugging tools window:

Enable checkbox
Figure showing the Enable checkbox for turning a breakpoint on.

Right-click in the Debugging tools window to access the menu, as shown in the following figure:

Right-click menu
Figure showing the right-click menu you access from the Debugging tools
                        window.

From this menu, you can enable or disable all breakpoints. You can delete the selected breakpoint or all breakpoints. You can search for a string in breakpoints.

Note: Leave the Debugging tools menu open while you test your automations, to enable or disable breakpoints as you step through the automation.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us