Study guide
15.1 Studio Debugging Tools: Breakpoints, Panels & Execution Control
UiPath Automation Developer Professional UiPath-ADPv1
Track your progress as you read
Finished sections get a check mark.
1 Chapter 1: Exam Overview & Blueprint Map
1.1 About the UiPath-ADPv1 Exam: Format, Fees & Policies 1.2 The Exam Topics Mapped to This Guide & a Study Plan
2 Chapter 2: REFramework Architecture & State Dynamics
2.1 State Machine Architecture & The Four Core States 2.2 Configuration Management: Settings, Constants, and Assets 2.3 Transaction Types & The Dispatcher vs. Performer Architecture 2.4 Adapting REFramework: Tabular Data, Collections & Linear Processes
3 Chapter 3: REFramework Exception Handling & Recovery
3.1 BusinessRuleException vs. System.Exception Handling Patterns 3.2 Retry Mechanisms: Queue Retries vs. REFramework MaxRetryNumber 3.3 Consecutive System Exceptions & Graceful Process Termination
4 Chapter 4: State Machines, Custom Log Fields & REFramework Testing
4.1 Building State Machine Projects in Studio 4.2 Logging Levels, Robot Logs & Custom Log Fields in REFramework 4.3 Testing a REFramework Project With and Without Orchestrator Queues
5 Chapter 5: LINQ Queries & DataTable Operations
5.1 LINQ Essentials for Collections & Filtering 5.2 Advanced DataTable Querying with LINQ 5.3 In-Memory DataTable Transformations & Column Operations
6 Chapter 6: Regex, DateTime, JSON & Invoke Activities
6.1 Regular Expressions & Text Parsing for Automation 6.2 DateTime Formatting, Timezone Conversions & TimeSpan Calculations 6.3 JSON Parsing, JSONPath & Serialization with Newtonsoft.Json 6.4 Invoke Method & Invoke Code Activities 6.5 Data Referencing in Invokes: DataTable, List & Dictionary Arguments
7 Chapter 7: Modern UI Automation & Unified Targeting
7.1 Modern Design Experience & The Unified Target Concept 7.2 Anchors, Relative Elements & UI Automation Activities 7.3 Dynamic Selectors, Variables & Wildcards in Selectors
8 Chapter 8: Object Repository, Computer Vision & Remote Runtime
8.1 Object Repository & UI Descriptor Libraries 8.2 AI Computer Vision for Unattended & Remote Interfaces 8.3 Automation in Virtual Environments & UiPath Remote Runtime
9 Chapter 9: Advanced UI Automation: Browser Modes, Agentic UI & macOS
9.1 Browser Automation with the WebDriver Protocol 9.2 Agentic UI Automation: ScreenPlay, Semantic Activities & Healing Agent 9.3 macOS Automation: Native Apps, Office Apps & AppleScript
10 Chapter 10: Advanced Control Flow & Exception Architecture
10.1 Flowcharts, Sequences & Parallel Control Flow Patterns 10.2 Global Exception Handler Architecture & ErrorAction Directives 10.3 TryCatch, Retry Scope & Custom Exception Architectures
11 Chapter 11: Orchestrator Queues & Transaction Management
11.1 Queue Architecture, SpecificContent & Transaction Lifecycles 11.2 Queue Items SLA, Postpone, Deadlines & Priority Scheduling 11.3 Bulk Operations, Transaction Status Updates & Queue Triggers
12 Chapter 12: Orchestrator Tenant & Folder Entities
12.1 Asset Types, Per-Robot Assets & External Credential Stores 12.2 Modern Folder Hierarchy, User/Robot Assignment & Permissions 12.3 Storage Buckets, Webhooks & Environment Promotion 12.4 Orchestrator Tags: Labels, Properties & Governance
13 Chapter 13: Unattended Execution, API Triggers & Cloud Robots
13.1 Unattended Job Execution: Folders, Priorities, Background vs. Foreground & Runtimes 13.2 API Triggers: Starting Jobs from External Systems over HTTP 13.3 Serverless and Cloud VM Robots: Cloud-Hosted Execution Options
14 Chapter 14: Monitoring, Recording & Solutions Management
14.1 Orchestrator Monitoring, Trigger Alerts & Job Health 14.2 Job and Transaction Recording: Troubleshooting Faulted Unattended Jobs 14.3 Solutions Management: Packaging and Deploying Automations with Their Resources
15 Chapter 15: Debugging, Remote Debugging & Profiling
15.1 Studio Debugging Tools: Breakpoints, Panels & Execution Control 15.2 Remote Debugging: Remote Machine and Unattended Robot Connections 15.3 Profile Execution: Finding Performance Bottlenecks in Studio
16 Chapter 16: RPA Testing & Test Suite
16.1 UiPath Test Suite Overview, Test Cases & Given-When-Then Structure 16.2 Data-Driven Testing, Test Verification Activities & Mock Activities 16.3 CI/CD Pipelines with uipcli & Test Manager Traceability
17 Chapter 17: Long-Running Workflows, Action Center & Apps
17.1 Long-Running Workflows: Persistence, Suspend and Resume 17.2 Action Center & Human-in-the-Loop Orchestration 17.3 UiPath Apps: Action Apps, Automations & Integration Service
18 Chapter 18: Trigger-Based Attended Automation & Callouts
18.1 Trigger-Based Attended Automation: Forms, Triggers & Global Variables 18.2 Running Local Triggers & the Event Inspection Tool 18.3 Callouts & Forms for Attended Guidance
19 Chapter 19: UiPath Assistant & Robot Sessions
19.1 UiPath Assistant: Automations, Reminders, Widgets & Configuration 19.2 Robot Session (Picture in Picture): Child Session vs. Virtual Desktop
20 Chapter 20: Autopilot for Developers & Autopilot for Everyone
20.1 Autopilot for Developers: AI Assistance in Studio and Studio Web 20.2 Autopilot for Everyone: Chat, Automations & Clipboard AI
21 Chapter 21: API Automation & Integration Service
21.1 Integration Service: Connectors, Connections & Connector Activities 21.2 API Workflows in Studio Web 21.3 HTTP Requests: Web APIs, the Orchestrator API & Connector Requests 21.4 Connector Builder: Custom Integration Service Connectors 21.5 Integration Service Event Triggers: Connected and Disconnected 21.6 GenAI Activities: Generative AI Inside Workflows
22 Chapter 22: Data Service, Context Grounding & Coded Workflows
22.1 Data Fabric (Data Service) Entities: Modeling Business Data 22.2 Data Fabric Activities and the Platform Connector 22.3 Context Grounding: Retrieval-Augmented Generation with Company Data 22.4 Coded Automations: Structure, Arguments & Invoking Workflows 22.5 Coded Automation Services: Orchestrator, UI Automation, Microsoft 365 & Custom Services
23 Chapter 23: Integrated Scenario Practice
23.1 Integrated Scenario Practice: Designing an End-to-End Solution
15.1 Studio Debugging Tools: Breakpoints, Panels & Execution Control
Key Takeaways Explain This Topic AI
F5 debugs the project from Main, F6 debugs the current file, F9 toggles a breakpoint, Pause breaks, and F12 stops.
Step Into opens containers and invoked workflows (read-only tab), Step Over runs them without opening, and Step Out finishes the current container.
Retry re-runs the previous activity, Ignore continues from the next activity, and Restart starts again from the first activity of the project.
Breakpoint settings are Condition (not validated), Hit Count (up to 32,767), Log Message (Trace level), and Continue execution when logging, which makes a non-pausing tracepoint.
The Locals panel is where values are edited while paused; Watch and Immediate evaluate, Call Stack shows the next activity and its parents, and Slow Step 1x is the slowest speed.
Last updated: September 2026
15.1 Studio Debugging Tools: Breakpoints, Panels & Execution Control
Core Concept: Studio's debugger lets you pause a workflow, step through activities, inspect and change values, and log information without stopping. Knowing exactly what each action and panel does, and what it does not do, is a common source of exam questions.
Starting a Debug Session
Debugging is available from the Design and Debug ribbon tabs, but not while project files have validation errors.
- Shortcut Action
- F5 Debug the project, starting with the file set as Main
- F6 Debug the currently opened file
- Ctrl + F5 / Ctrl + F6 Run the project / run the current file without debugging
- F9 Toggle a breakpoint on the selected activity
- F11 / F10 / Shift + F11 Step Into / Step Over / Step Out
- Pause Pause (Break) the execution, in normal and debug mode
- F12 Stop the execution, in normal and debug mode
Right-clicking an activity also offers Run to this Activity , Run from this Activity , and Test Activity , which runs one activity in the debugger and asks for the values of the variables it uses.
Stepping and Recovery Actions
Action What it does
Step Into Debugs activities one at a time. For Invoke Workflow File , the invoked workflow opens in a new tab in read-only mode and its activities run one by one
Step Over Runs the next activity; containers such as sequences, flowcharts, and Invoke Workflow File are highlighted but not opened
- Step Out Completes the activities in the current container and pauses at the level of that container
- Retry Re-executes the previous activity and throws the exception again if it recurs
- Ignore Ignores the exception and continues from the next activity
Restart Available after an exception paused debugging; restarts from the first activity of the project, or from the activity chosen with Run from this Activity
- Break Pauses at any moment; then choose Continue, Step Into, Step Over, or Stop
- Focus Returns the designer to the current execution point, breakpoint, or failing activity
Warning
Ignore skips the failing activity, so its output variables are never set. Later activities that use them often fail with a NullReferenceException .
While debugging is paused, you can also change the properties of the current activity , such as its selector, timeout, or inputs, from the Properties panel or the designer. The activity runs with the new values when execution resumes, and when debugging ends Studio asks whether to keep the changes.
Debug Ribbon Options
Option Behavior
Slow Step Highlights and opens each activity and container as it runs, like Step Into but without pausing. It has 4 speeds : 1x is the slowest and 4x the fastest ; each click moves to the next speed
Execution Trail Off by default. Marks executed activities in green and activities that threw an exception in red ; activities that did not run stay unmarked
Highlight Elements Highlights UI elements as they are used during debugging
Log Activities Shows each debugged activity as a Trace log in the Output panel. Highlight Elements and Log Activities can only be toggled before debugging
Continue on Exception Off by default. When off, an error stops debugging and highlights the failing activity (or passes the error to a Global Exception Handler if one is set). When on, the exception is logged and execution continues
- Picture in Picture Runs or debugs in a separate session or virtual desktop
- Remote Debugging Sends run and debug operations to a remote robot
- Profile Execution Measures how long each activity takes (see the Profile Execution section)
- Breakpoints and Tracepoints
Toggle a breakpoint with F9 , the Toggle Breakpoint context menu, or the Breakpoints button on the Debug tab. A breakpoint pauses execution before the activity runs. Breakpoints persist when you reopen the project and affect only debugging, not normal runs.
Breakpoint Settings fields:
Field Meaning
Condition Breaks only when the expression is true. The expression is not validated , so typos only show up at run time
Hit Count The number of times the condition must be met before execution breaks; maximum 32,767
Log Message A message logged at Trace level in the Output panel when the breakpoint is reached (or its condition is met)
Continue execution when logging Logs the message without pausing; available only after a log message is set
The four types follow from these settings:
Breakpoint: no settings; always pauses.
Conditional breakpoint: a condition and/or hit count.
Tracepoint: a log message. With Continue execution when logging selected, it logs without stopping.
Conditional tracepoint: a condition or hit count plus a log message.
The Breakpoints panel lists them all and can enable, disable, or delete all breakpoints, and Focus jumps to one in the designer.
Debugging Panels
Panel Shows Can you change values here?
Locals The exception (description and type), arguments, variables, the input and output properties of the previously executed activity, and the properties of the current activity Yes. While paused, open a value's Local Value window to edit variables, arguments, and the current activity's properties. Edits are not saved to the file
Watch Variables, arguments, and expressions you add; values update after each activity No, it displays values
Immediate The result of a variable, argument, or statement you type and submit with Enter; keeps a history you can clear Used to evaluate , not documented as a place to assign values
Call Stack The next activity to run and its parent containers; an activity that threw an exception is marked and highlighted in red No; double-click an item to focus it in the designer
Notes:
Add an item to the Watch panel by typing it in the Add Watch field, or with Add to Watch from the Locals panel or Add Watch from the Variables or Arguments panel.
In the Immediate panel, use parentheses for method calls, for example Names.First().ToUpper .
Changing values from the Variables or Arguments panel or the Data Manager is not supported during debugging; use the Locals panel.
Large values are truncated in both the Locals and Immediate panels.
Walkthrough: An Intermittent Business Rule Failure
A performer occasionally marks invoices as business exceptions when they look valid.
Set a conditional breakpoint on the validation activity with the condition String.IsNullOrWhiteSpace(in_TransactionItem.SpecificContent("ApproverID").ToString) .
Debug the file with F6. Execution pauses only for suspicious items.
Inspect the Locals panel: ApproverID holds three spaces instead of an empty string.
Evaluate in the Immediate panel: in_TransactionItem.SpecificContent("ApproverID").ToString.Trim.Length returns 0 .
Fix and verify: update the validation to trim the value, change the test value in the Locals panel's Local Value window, and continue to confirm the new branch.
Replace the breakpoint with a tracepoint that logs the approver value and continues, to watch a full batch without stopping.