Initial

Author: iopanag

support/power-platform/power-automate/desktop-flows/ui-automation/ui-rdp-automation/collecting-debug-logs.md

@@ -0,0 +1,34 @@
+---
+title: Collecting debug logs from agent for Virtual desktops
+description: Guide on how to collect debug logs from remote agent to further investigate issues.
+ms.reviewer: amitrou
+ms.author: iopanag
+author: JohnPanagiotopoulos
+ms.custom: sap:Desktop flows\UI or browser automation
+ms.date: 20/03/2025
+---
+
+# Collecting debug logs from agent for Virtual desktops
+
+This article will help you collect debug logs from remote Agent for Virtual Desktops. Most of the times this is not needed. However, when you have exhausted all troubleshooting methods for an RDP/Citrix issue, collecting debug logs from the remote machine might help with investigation.
+
+## How to enable
+
+1. Login on the remote machine that is affected and set an environment variable either machine-wide or to specific affected user.
+
+    - Name: **PAD_DEBUG_RDP**
+    - Value: **true**
+
+> [!NOTE]
+> You might need administrator rights on the remote machine to change environment variables.
+
+2. Log out of the remote affected session and log back in for the variable to take effect.
+3. Run the agent and try to perform the usual automation the user is trying to do.
+4. Afterwards check on the remote session Desktop folder for a folder named **PAD_RDP_DEBUG**
+5. Copy this folder to the desired machine.
+6. Check the logs for information you might not want to share.
+7. Remove the **PAD_DEBUG_RDP** environment variable from the remote machine to avoid to disable writing logs.
+
+## More information
+
+[Automate on virtual desktops](/power-automate/desktop-flows/virtual-desktops)

support/power-platform/power-automate/desktop-flows/ui-automation/ui-rdp-automation/configuring-timeouts.md

@@ -0,0 +1,29 @@
+---
+title: Configuring timeouts for RDP/Citrix automations
+description: Guide on how configure certain timeout that affect RDP/Citrix automations on Power Automate.
+ms.reviewer: amitrou
+ms.author: iopanag
+author: JohnPanagiotopoulos
+ms.custom: sap:Desktop flows\UI or browser automation
+ms.date: 20/03/2025
+---
+
+# Configuring timeouts for RDP/Citrix automations
+
+There might be cases where interacting with RDP/Citrix applications might timeout and require additional time to work. These can be configured like the rest of Power Automate timeouts like in [Timeout configuration for UI and browser automation](https://learn.microsoft.com/en-us/power-automate/desktop-flows/how-to/ui-automation-change-timeout-cofiguration). Use this guide to configure the following values as needed.
+
+## Issue: Something takes long time and fails afterwards
+
+The webpage/application may not repond fast to Power Automate requests. This is probably to application/webpage misbehaviour or bad connection to RDP/Citrix environment. Depending the application type you can extend the max wait time Power Automate will wait for response from the application:
+
+- **Java.Bridge.Client.ReadWriteTimeout**: In case the target application is JAVA based, this will additionally increase time waiting for responses. In remote JAVA applications (RDP/Citrix), this is needed to be changed on the remote machine.
+- **BrowserNativeMessageHost.MessageTimeout** and **WebExtensionsMessageProxy.SendTimeout**: In case web automation is used, this will increase the max time that will wait for webpage to respond. In remote webpages (RDP/Citrix), this is needed to be changed on the remote machine.
+- **RDP.Client.CallTimeOut**: When the application/webpage is on a remote machine, either RDP or Citrix. This will will additionaly increase the max time that will wait for the remote application/webpage to respond.
+
+If the problem is design oriented (e.g. failing to capture an Element from the designer), you will also need to configure the following too:
+
+- **AutomationServerEndpoint.DesignTime.CallTimeout**: This will increase the time the Power Automate Designer will wait for response.
+
+If the problem is in runtime (when running the flow), you will also need to configure the following too:
+
+- **AutomationServerEndpoint.Runtime.CallTimeout**: This will increase the max time that runtime will wait for an action to be performed.

support/power-platform/power-automate/desktop-flows/ui-automation/ui-rdp-automation/media/troubleshooting-with-the-troubleshooter/launch-troubleshooter-menu.png

@@ -0,0 +1,30 @@
+---
+title: Elements are highlighted but on runtime clicks are not happening on Citrix Virtual apps
+description: Solves an issue that occurs when hovering over elements in Citrix Virtual apps works but on runtime clicks do not work
+ms.reviewer: amitrou
+ms.author: iopanag
+author: JohnPanagiotopoulos
+ms.custom: sap:Desktop flows\UI or browser automation
+ms.date: 03/03/2025
+---
+# Elements are highlighted but on runtime clicks are not happening on Citrix Virtual apps
+
+This article helps you resolve an issue you may encounter when trying to click an element in Citrix Virtual apps.
+
+## Symptoms
+
+When you hover the mouse cursor over a UI or web element of an application or webpage inside a Citrix virtual app with [UI element picker](/power-automate/desktop-flows/ui-elements#ui-elements-types) the elements are highlighted and captured, however when used in an action, the interaction is not happening and no error is shown. Test selector works fine.
+
+## Cause
+
+The Citrix Workspace HI DPI settings are interfering with PAD interactions. Mostly affected setups with multiple monitors.
+
+## Resolution
+
+1. Disable Citrix Workspace HIDPI option. From the tray icon right click on the Citrix Workspace icon.
+2. Click on 'Advanced Preferences'.
+3. Click on 'High DPI' link.
+4. On the options shown, select the 'Let the operating system scale the resolution'.
+5. Click 'Save' and close the remaining Citrix workspace preferences windows.
+6. Close any Citrix Desktops or Virtual apps and start them again.
+7. If needed change the Desktop scaling of the machine running PAD to 100%. For unattended machines follow these instructions: [Set screen resolution on unattended mode - Power Automate](https://learn.microsoft.com/en-us/power-automate/desktop-flows/how-to/set-screen-resolution-unattended-mode)

support/power-platform/power-automate/desktop-flows/ui-automation/ui-rdp-automation/media/troubleshooting-with-the-troubleshooter/troubleshooter-rdp-issues.png

@@ -0,0 +1,34 @@
+---
+title: Troubleshooting RDP or Citrix issues with the Troubleshooter
+description: Guide on how use the Power Automate troubleshooter to diagnose RDP/Citrix automation issues.
+ms.reviewer: amitrou
+ms.author: iopanag
+author: JohnPanagiotopoulos
+ms.custom: sap:Desktop flows\UI or browser automation
+ms.date: 20/03/2025
+---
+
+# Troubleshooting RDP or Citrix issues with the Troubleshooter
+
+This article will help you use the Power Automate troubleshooter to diagnose and potentialy solve issues related to RDP or Citrix automation. When faced with such issues, the troubleshooter should be the first course of actions for diagnosing the problem.
+
+## How to diagnose issues with the troubleshooter
+
+1. Make sure the problematic remote RDP/Citrix session/app is up. The troubleshooter will attempt to connect with it to check for issues.
+2. Launch the troubleshooter from the Power Automate menu, `Help -> Troubleshooter`
+
+   :::image type="content" source="media/troubleshooting-with-the-troubleshooter/troubleshooting-with-the-troubleshooter.png" alt-text="Screenshot of the Power Automate designer help menu with the Troubleshooter option highlighted.":::
+
+3. Click on the `Run` button of the `Troubleshoot UI/Web automation issues` section.
+
+   :::image type="content" source="media/troubleshooting-with-the-troubleshooter/troubleshooter-uiautomation-option.png" alt-text="Screenshot of the Power Automate troubleshooter with the 'Run' button of 'UI/Web automation' section highlighted":::
+
+4. After the troubleshooter completes its checks, expand the 'RDP/Citrix UI Automation' section by clicking the right arrow next to it.
+
+   :::image type="content" source="media/troubleshooting-with-the-troubleshooter/troubleshooter-rdp-issues.png" alt-text="Screenshot of the Power Automate troubleshooter with the 'RDP/Citrix UI Automation' section expanded and a list off issues are shown in a list along with detected RDP/Citrix clients with its separate issues":::
+
+5. The section shows the errors detected and possible solutions where apply. Furthermore for each RDP/Citrix session/app that was detected, more detailed errors are displayed for each.
+
+## More information
+
+[Automate on virtual desktops](/power-automate/desktop-flows/virtual-desktops)