Debugging Tasks

Task Builder allows you to visually construct and troubleshoot the steps that an Automate task performs before it is put into production. It contains many debugging tools that makes it faster and easier to find and resolve issues in your task. You can use breakpoints to pause execution and observe certain elements of a specific step in order to pinpoint the cause of an errant task, or use the various run options to navigate through the steps of your task in different ways, including the ability to start execution from a specific step, run only selected steps, or run each step one by one. The Debug panel allows you to view variable and dataset values or evaluate expressions while the task is suspended.

Debugging Tools & Techniques

The table below describes various Task Builder debugging techniques that you can apply in order to test and troubleshoot a task:

Technique Description
Attachments Jumps to a particular step in the Steps panel where a breakpoint resides.
Bookmarks Removes the selected breakpoints. To select multiple breakpoints, hold down CTRL during selection.
Breakpoints Removes all breakpoints contained in the task.
Comments Opens the help topic regarding this subject.
Regions Jumps to a particular step in the Steps panel where a breakpoint resides.
Run Options Removes the selected breakpoints. To select multiple breakpoints, hold down CTRL during selection.
Watches Removes all breakpoints contained in the task.

NOTE: If you import a task that includes an unlicensed action/activity, the Steps panel will display the unlicensed step (in Visual view) as currently unlicensed. Running a task that includes an unlicensed step will always fail at that step. You can bypass the step by disabling it or removing it altogether.