Additions

Author: iopanag

support/power-platform/power-automate/desktop-flows/ui-automation/ui-rdp-automation/error-remote-desktop-not-found.md

@@ -0,0 +1,53 @@
+---
+title: Error: The remote desktop was not found
+description: Solves an issue that occurs when on runtime the flow fails with 'The remote desktop was not found'
+ms.reviewer: amitrou
+ms.author: iopanag
+author: JohnPanagiotopoulos
+ms.custom: sap:Desktop flows\UI or browser automation
+ms.date: 03/03/2025
+---
+# Error: The remote desktop was not found
+
+This article helps you resolve an issue you may encounter when a flow fails with error 'The remote desktop was not found'.
+
+## Symptoms
+
+A flow using RDP/Citrix automation used to run successfully but it started failing with error 'The remote desktop was not found'. It might even never run successfully. This is more common in Citrix Virtual Apps.
+
+## Cause 1
+
+The RDP Window/Citrix Desktop/Virtual App might have changed name since when the elements were captured and tracking them with the old name fails.
+
+### Resolution
+
+You can repair the selectors used to retract the RDP Window/Citrix Desktop/Virtual App like normal window selectors:
+
+1. Make sure the affected RDP Window/Citrix Desktop/Virtual App is up.
+2. Find the desktop element that has the problem in the "UI Elements" pane on Designer and double click it to open the its selector editor.
+
+   :::image type="content" source="media/error-remote-desktop-not-found/control-repo-desktop.png" alt-text="Screenshot of the Power Automate elements section with a Citrix desktop element highlighted.":::
+
+3. Click on "Repair" button and capture the new Desktop/App. Check the suggested changes and accept them.
+
+   :::image type="content" source="media/error-remote-desktop-not-found/rdp-selector-builder-repair.png" alt-text="Screenshot of the Power Automate selector builder window with the repair button highlighted":::
+
+4. After Accepting the changes, Click on the "Test" to test the new selector.
+5. [Optionally if needed] You can use the "New" Button to add additional fallback selectors for the desktop.
+
+## Cause 2
+
+The usage of Citrix Virtual App with certain applications causes the creation of incorrect target desktop selector using ordinal, especially when interacting with combo box listes.
+
+### Resolution
+
+1. Make sure the affected RDP Window/Citrix Desktop/Virtual App is up.
+2. Find the desktop element that has the problem in the "UI Elements" pane on Designer and double click it to open the its selector editor.
+
+   :::image type="content" source="media/error-remote-desktop-not-found/control-repo-desktop.png" alt-text="Screenshot of the Power Automate elements section with a Citrix desktop element highlighted.":::
+
+3. Check if the selector is using ordinal (eq is checked). If it uses, **uncheck** it and save it.
+
+   :::image type="content" source="media/error-remote-desktop-not-found/rdp-selector-builder-ordinal.png" alt-text="Screenshot of the Power Automate elements section with a Citrix desktop element highlighted.":::
+
+4. Click on the "Test" to test the new selector.

support/power-platform/power-automate/desktop-flows/ui-automation/ui-rdp-automation/media/error-remote-desktop-not-found/control-repo-desktop.png

@@ -65,11 +65,15 @@ The communication with the remote agent components doesn't work.
      Set the **Virtual channel allow list for DVC** policy with the following values:
 
       - `C:\Program Files (x86)\Power Automate agent for virtual desktops\PAD.RDP.ControlAgent.exe,Microsoft.Flow.RPA.Desktop.UIAutomation.RDP.DVC.Plugin,PAD\CONTROL`
-  
+
       - `C:\Users\*\AppData\Local\Microsoft\Power Automate Desktop\RDP Automation Agents\*\PAD.RDP.AutomationAgent.exe,Microsoft.Flow.RPA.Desktop.UIAutomation.RDP.DVC.Plugin,PAD\UIA`
 
       Ensure Citrix machines are restarted after applying the policy.
 
+5. If the agent is running and no error is shown on the tray icon, then run the troubleshooter in UI Automation section while the RDP/Citrix window/app is running. Check for issues. If the troubleshooter is reporting error, check the details.
+
+   :::image type="content" source="media/rdp-no-highlight/rdp-access-denied.png" alt-text="Screenshot of the Power Automate troubleshooter with highlighted the RDP/Citrix issue details.":::
+
 ## More information
 
 [Automate on virtual desktops](/power-automate/desktop-flows/virtual-desktops)