Skip to content

Commit 42fe842

Browse files
authored
some changes
1 parent b96d60e commit 42fe842

5 files changed

Lines changed: 91 additions & 57 deletions

File tree

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,58 @@
11
---
2-
title: Error "The remote desktop wasn't found"
3-
description: Solves an issue that occurs when on runtime the flow fails with 'The remote desktop wasn't found'
2+
title: The Remote Desktop Wasn't Found Error
3+
description: Solves an error that occurs when you use Remote Desktop Protocol (RDP) or Citrix automation in Microsoft Power Automate.
44
ms.reviewer: amitrou
55
ms.author: iopanag
66
author: iopanag
77
ms.custom: sap:Desktop flows\UI or browser automation
8-
ms.date: 03/28/2025
8+
ms.date: 04/15/2025
99
---
10-
# Error "The remote desktop wasn't found"
10+
# A desktop flow fails with the "The remote desktop wasn't found" error
1111

12-
This article helps you resolve an issue you might encounter when a flow fails with error 'The remote desktop wasn't found'.
12+
This article helps you resolve the issue where a flow fails with the "The remote desktop wasn't found" error when using Microsoft Remote Desktop Protocol (RDP) or Citrix automation in Microsoft Power Automate.
1313

1414
## Symptoms
1515

16-
A flow using RDP/Citrix automation used to run successfully but it started failing with error 'The remote desktop wasn't found'. It might even never run successfully. This issue is more common in Citrix Virtual Apps.
16+
A flow using [Remote Desktop Protocol (RDP) or Citrix automation](/power-automate/desktop-flows/virtual-desktops) that previously ran successfully might start failing with the following error:
17+
18+
> The remote desktop wasn't found.
19+
20+
In some cases, the flow might never run successfully. This issue is more commonly observed in Citrix Virtual Apps.
1721

1822
## Cause 1
1923

20-
The RDP Window/Citrix Desktop/Virtual App might changed name since when the elements were captured and tracking them with the old name fails.
24+
The name of the RDP window, Citrix Desktop, or Citrix Virtual Apps may have changed since the original [UI elements](/power-automate/desktop-flows/virtual-desktops#distinguish-ui-elements-captured-on-virtual-desktops) were captured. Tracking these elements with the old name can fail.
2125

2226
### Resolution
2327

24-
You can repair the selectors used to retract the RDP Window/Citrix Desktop/Virtual App like normal window selectors:
28+
You can [repair the selectors](/power-automate/desktop-flows/repair-selector) used to track the RDP window, Citrix Desktop, or Citrix Virtual Apps as follows:
2529

26-
1. Make sure the affected RDP Window/Citrix Desktop/Virtual App is up.
27-
2. Find the desktop element that has the problem in the "UI Elements" pane on Designer and double click it to open the selector editor.
30+
1. Ensure the affected RDP window, Citrix Desktop, or Citrix Virtual Apps is active.
31+
2. Locate the desktop element causing the issue in the [UI elements](/power-automate/desktop-flows/ui-elements#ui-elements) pane in the flow designer. Double-click it to open the selector editor.
2832

2933
:::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.":::
3034

31-
3. Select on "Repair" button and capture the new Desktop/App. Check the suggested changes and accept them.
35+
3. Select the **Repair** button and capture the new desktop or app. Review the suggested changes and accept them.
36+
37+
:::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.":::
3238

33-
:::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":::
39+
4. After accepting the changes, select **Test** to verify the new selector. For more information, see [Test a selector](/power-automate/desktop-flows/test-selectors).
3440

35-
4. After Accepting the changes, select "Test" to test the new selector.
36-
5. [Optionally if needed] You can use the "New" Button to add more fallback selectors for the desktop.
41+
5. (Optionally) Use the **New** button to add more fallback selectors for the desktop, if necessary.
3742

3843
## Cause 2
3944

40-
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 lists.
45+
When you use Citrix Virtual Apps with certain applications, an incorrect target desktop selector may be created using an ordinal value (for example, **eq**) instead of a more robust selection method. This is particularly common when interacting with combo box lists.
4146

4247
### Resolution
4348

44-
1. Make sure the affected RDP Window/Citrix Desktop/Virtual App is up.
45-
2. Find the desktop element that has the problem in the "UI Elements" pane on Designer and double click it to open the selector editor.
49+
1. Ensure the affected RDP window, Citrix Desktop, or Citrix Virtual Apps is active.
50+
2. Locate the desktop element causing the issue in the [UI elements](/power-automate/desktop-flows/ui-elements#ui-elements) pane in the flow designer. Double-click it to open the selector editor.
4651

4752
:::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 app element highlighted.":::
4853

49-
3. Check if the selector is using ordinal (eq is checked). If it uses, **uncheck** it and save it.
54+
3. Check if the selector is using an ordinal value (the **eq** is selected.) If it is, clear the value and save the change.
5055

51-
:::image type="content" source="media/error-remote-desktop-not-found/rdp-selector-builder-ordinal.png" alt-text="Screenshot of the Power Automate selector builder window with ordinal attribute checkbox unchecked":::
56+
:::image type="content" source="media/error-remote-desktop-not-found/rdp-selector-builder-ordinal.png" alt-text="Screenshot of the Power Automate selector builder window with an ordinal attribute checkbox cleared.":::
5257

53-
4. Click on the "Test" to test the new selector.
58+
4. Select **Test** to verify the new selector. For more information, see [Test a selector](/power-automate/desktop-flows/test-selectors).
Lines changed: 20 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,36 @@
11
---
2-
title: Elements are highlighted but on runtime clicks aren't happening on Citrix Virtual apps
3-
description: Solves an issue that occurs when hovering over elements in Citrix Virtual apps works but on runtime clicks don't work
2+
title: Can't Click Elements In Citrix Virtual Apps
3+
description: Solves an issue where hovering over elements in Citrix Virtual Apps works but clicking the elements during runtime don't work.
44
ms.reviewer: amitrou
55
ms.author: iopanag
66
author: iopanag
77
ms.custom: sap:Desktop flows\UI or browser automation
8-
ms.date: 03/28/2025
8+
ms.date: 04/15/2025
99
---
10-
# Elements are highlighted but on runtime clicks aren't happening on Citrix Virtual apps
10+
# Elements are highlighted in Citrix Virtual Apps but runtime clicks on the elements don't work
1111

12-
This article helps you resolve an issue you might encounter when trying to click an element in Citrix Virtual apps.
12+
This article provides steps to resolve an issue where UI element interactions don't occur when running actions in Citrix Virtual Apps, despite the elements being properly highlighted and captured.
1313

1414
## Symptoms
1515

16-
When you use the [UI element picker](/power-automate/desktop-flows/ui-elements#ui-elements-types) on Citrix Virtual apps, you're able to highlight and capture elements. However when these elements are used in an action (like 'Click Element in Window'), the interaction isn't happening and no error is shown. Test selector works fine.
16+
When you use the [UI element picker](/power-automate/desktop-flows/ui-elements#ui-elements-types) to interact with Citrix Virtual Apps, you can highlight and capture elements successfully. However when these captured elements are used in an action (for example, **Click Element in Window**), the interaction doesn't execute, and no error message is displayed. The [Test Selector](/power-automate/desktop-flows/test-selectors) functionality works as expected.
1717

1818
## Cause
1919

20-
The Citrix Workspace HIDPI settings are interfering with PAD interactions. Mostly affected setups with multiple monitors.
20+
The Citrix Workspace High DPI (HIDPI) settings may interfere with Power Automate for desktop interactions. This issue is commonly observed in setups involving multiple monitors.
2121

2222
## Resolution
2323

24-
1. Disable Citrix Workspace HIDPI option. From the tray icon right click on the Citrix Workspace icon.
25-
2. Select 'Advanced Preferences'.
26-
3. Click on 'High DPI' link.
27-
4. On the options shown, select the 'Let the operating system scale the resolution'.
28-
5. Click 'Save' and close the remaining Citrix workspace preferences windows.
29-
6. Close any Citrix Desktops or Virtual apps and start them again.
30-
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](/power-automate/desktop-flows/how-to/set-screen-resolution-unattended-mode)
24+
To solve this issue, follow these steps:
25+
26+
1. Disable the Citrix Workspace HIDPI option:
27+
28+
1. From the system tray, right-click the Citrix Workspace app icon.
29+
1. Select **Advanced Preferences** > **High DPI**.
30+
1. In the **High DPI** settings, select the **Let the operating system scale the resolution** option.
31+
1. Select **Save** and close the Citrix Workspace preferences windows.
32+
33+
1. Close any active Citrix Desktops or Virtual Apps.
34+
1. Restart the Citrix Desktops or Virtual Apps.
35+
36+
1. (Optional) Adjust the desktop scaling of the machine running Power Automate for desktop to 100%. For unattended machines, see [Set screen resolution on unattended mode](/power-automate/desktop-flows/how-to/set-screen-resolution-unattended-mode).

support/power-platform/power-automate/desktop-flows/ui-automation/ui-rdp-automation/rdp-no-highlight.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ ms.reviewer: amitrou
55
ms.author: nimoutzo
66
author: NikosMoutzourakis
77
ms.custom: sap:Desktop flows\UI or browser automation
8-
ms.date: 03/28/2025
8+
ms.date: 04/15/2025
99
---
1010
# UI element isn't highlighted or an error occurs when hovering over a UI or web element
1111

12-
This article helps you resolve issues you might encounter when using the UI element picker in virtual desktops, such as Citrix or Remote Desktop Protocol (RDP) environments.
12+
This article helps you resolve issues you might encounter when using the UI element picker in virtual desktops, such as Citrix or Microsoft Remote Desktop Protocol (RDP) environments.
1313

1414
## Symptoms
1515

@@ -37,9 +37,10 @@ The communication with the remote agent components doesn't work.
3737
> The troubleshooter can be manually opened via the console and the flow designer, through the dedicated menu under **Help** > **Troubleshooter**. It can also be opened via the process file **PAD.Troubleshooter.exe**, which can be found in the installation folder of Power Automate for desktop.
3838
3939
1. Run **Troubleshoot UI/Web automation issues** to view the diagnostics for the communication. If an error appears in the Citrix or RDP section, expand it for more details and solutions.
40-
1. If the details indicate "Access is Denied", then policies in the remote machine prohibit to run a specific agent component from the user profile folder. Contact your administrator to allow the executables to run from these directories.
4140

42-
:::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.":::
41+
1. If the error details indicate "Access is denied," then policies in the remote machine prohibit to run a specific agent component from the user profile folder. Contact your administrator to allow the executables to run from these directories.
42+
43+
:::image type="content" source="media/rdp-no-highlight/rdp-access-denied.png" alt-text="Screenshot of the Power Automate troubleshooter that shows the Access is denied error details.":::
4344

4445
2. If the troubleshooter indicates that the remote agent isn't running, check if the agent is running in the Citrix or RDP session.
4546

Lines changed: 36 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,51 @@
11
---
2-
title: Something takes long time and fails afterwards
3-
description: This article guides through the procedure that is needed to resolve an issue when interactions with RDP/Citrix applications take long and fail after some time.
2+
title: Operation Takes a Long Time and Fails During Runtime
3+
description: This article guides through the procedure that's needed to resolve an issue when interactions with RDP or Citrix applications take long and fail during runtime in Power Automate.
44
ms.reviewer: amitrou
55
ms.author: iopanag
66
author: iopanag
77
ms.custom: sap:Desktop flows\UI or browser automation
8-
ms.date: 03/28/2025
8+
ms.date: 04/15/2025
99
---
10+
# Operation takes a long time and fails during runtime in Power Automate
1011

11-
# Something takes long time and fails afterwards
12+
his article provides guidance on resolving an issue where operations take a long time during runtime and eventually fail in Power Automate.
1213

13-
When trying to highlight, capture, test an element or interacting with elements on runtime, the operation takes a long time and fails afterwards.
14+
## Symptoms
1415

15-
The reson for this is that there might be cases where interacting with RDP/Citrix applications might timeout and require more time to work. These time-outs can be configured like the rest of Power Automate time-outs like in [time-out configuration for UI and browser automation](/power-automate/desktop-flows/how-to/ui-automation-change-timeout-cofiguration). Use this guide to configure the following values as needed.
16+
When you try to highlight, capture, test an element, or interact with elements during runtime in Power Automate, you may notice that the operation takes a significant amount of time and ultimately fails.
1617

17-
The specific configrations that need to be changed in this case are the following keys:
18+
## Cause
1819

19-
- **Java.Bridge.Client.ReadWriteTimeout**: In case the target application is JAVA based, this time-out additionally increases time waiting for responses. In remote JAVA applications (RDP/Citrix), this time-out needs to be changed on the remote machine.
20-
- **BrowserNativeMessageHost.MessageTimeout** and **WebExtensionsMessageProxy.SendTimeout**: In case web automation is used, this time-out increases the max time that waits for webpages to respond. In remote webpages (RDP/Citrix), this time-out needs to be changed on the remote machine.
21-
- **RDP.Client.CallTimeOut**: When the application/webpage is on a remote machine, either RDP or Citrix. This time-out additionally increases the max time that waits for the remote application/webpage to respond.
20+
The issue occurs due to default timeout settings in Power Automate that may be insufficient for certain scenarios, such as interacting with Microsoft Remote Desktop Protocol (RDP) or Citrix Virtual Apps. These timeouts may need to be adjusted to accommodate the increased time required for communication between the local and remote environments.
2221

23-
If the problem is design oriented (for example, failing to capture an Element from the designer), you also need to configure the following too:
22+
## Resolution
2423

25-
- **AutomationServerEndpoint.DesignTime.CallTimeout**: This increases the time the Power Automate Designer waits for response.
24+
To resolve the issue, modify the following timeout settings as needed. For more information about configuring these values, see [time-out configuration for UI and browser automation](/power-automate/desktop-flows/how-to/ui-automation-change-timeout-cofiguration).
2625

27-
If the problem is in runtime (when running the flow), you also need to configure the following too:
26+
- **Java.Bridge.Client.ReadWriteTimeout**
2827

29-
- **AutomationServerEndpoint.Runtime.CallTimeout**: This increases the max time that runtime waits for an action to be performed.
28+
- Use this setting if the target application is Java-based.
29+
- This timeout increases the waiting time for responses from Java applications.
30+
- For remote Java applications (for example, on RDP or Citrix), configure this timeout on the remote machine.
31+
32+
- **BrowserNativeMessageHost.MessageTimeout** and **WebExtensionsMessageProxy.SendTimeout**
33+
- Use these settings if web automation is being used.
34+
- These timeouts increase the maximum waiting time for webpages to respond.
35+
- For webpages in remote environments (for example, RDP or Citrix), configure these timeouts on the remote machine.
36+
37+
- **RDP.Client.CallTimeOut**
38+
- Use this setting when interacting with applications or webpages on a remote machine via RDP or Citrix.
39+
- This timeout increases the maximum waiting time for responses from remote applications or webpages.
40+
41+
## Additional timeout settings
42+
43+
Depending on whether the issue occurs during design time or runtime, additional timeout settings may need to be configured:
44+
45+
- For design-time issues (for example, failing to capture an element from the designer), adjust the following setting:
46+
47+
- **AutomationServerEndpoint.DesignTime.CallTimeout**: This setting increases the time the Power Automate Designer waits for response.
48+
49+
- For runtime issues (for example, failing during the execution of a flow), adjust the following setting:
50+
51+
- **AutomationServerEndpoint.Runtime.CallTimeout**: This setting increases the maximum waiting time during runtime for an action to be executed.

support/power-platform/power-automate/toc.yml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -90,24 +90,24 @@
9090
href: desktop-flows/ui-automation/desktop-application-crashes-ui-automation.md
9191
- name: Can't access the elements of a Java application
9292
href: desktop-flows/ui-automation/cannot-access-java-application-elements.md
93+
- name: Clicking the elements don't work during runtime
94+
href: desktop-flows/ui-automation/ui-rdp-automation/no-clicks-on-runtime.md
9395
- name: Focus window action can't bring a window to focus
9496
href: desktop-flows/ui-automation/focus-window-action-not-working.md
9597
- name: Failed to get UI element
9698
href: desktop-flows/ui-automation/failed-get-ui-element.md
9799
- name: Failed to get element/window or Element/Window wasn't found errors
98100
href: desktop-flows/ui-automation/ui-automation-action-fails-errors.md
101+
- name: Operation takes a long time and fails during runtime
102+
href: desktop-flows/ui-automation/ui-rdp-automation/something-takes-long-and-fails.md
99103
- name: SAP UI element click issue
100104
href: desktop-flows/ui-automation/ui-sap-automation/sap-click-element-dpi.md
101105
- name: Set drop-down list value in window/on web page action fails
102106
href: desktop-flows/ui-automation/set-drop-down-list-value-fails.md
103107
- name: UI element highlighting or hovering issues in virtual desktops
104108
href: desktop-flows/ui-automation/ui-rdp-automation/rdp-no-highlight.md
105-
- name: Elements are highlighted but on runtime clicks are not happening on Citrix Virtual apps
106-
href: desktop-flows/ui-automation/ui-rdp-automation/no-clicks-on-runtime.md
107-
- name: Error "The remote desktop was not found"
109+
- name: '"The remote desktop was not found" error'
108110
href: desktop-flows/ui-automation/ui-rdp-automation/error-remote-desktop-not-found.md
109-
- name: Something takes long time and fails afterwards
110-
href: desktop-flows/ui-automation/ui-rdp-automation/something-takes-long-and-fails.md
111111
- name: UIPI issues with UI and web automation actions
112112
href: desktop-flows/ui-automation/uipi-issues.md
113113
- name: '"Could not read the application certificate" error when creating a connection'

0 commit comments

Comments
 (0)