How to work with multiple displays

Desktop UI

Leapwork follows the primary active window in a desktop UI, this means that Leapwork will search for a single active window across all displays used, this enables the user to use multiple displays in parallel for Desktop UI case automation. 

While following an active window during case execution, Leapwork records a video of these active windows, which ensures that all steps followed during a case execution are captured accurately, irrespective of the display used during test execution. 

Web Automation

Leapwork follows the active window during a web application automation case, which ensures that it captures a video of the screen under test.

Virtual Desktop

In virtual desktop automation, Leapwork follows the environment defined, Preview environment for local displays, for capturing images. For example, if the user-defined Local (Display 2) is in the Preview environment, the capture mode on Local (Display 2) will be highlighted only.

It is not possible to capture images in the Preview environment using the Local Agent while capturing. Leapwork will become the active window, resulting in the infinite mirror screen.  

When a user runs a case, the beginning of the case will start with the active desktop display, even during test execution, as it will follow the active window. Review the following examples for more information:

A user has two monitors: Local (Display 1) and Local (Display 2) 

1. Leapwork is running on Local (Display 1) and the Preview environment is set to Local (Display 1)

   When a user clicks the Run button from the Preview environment, the test will start by minimizing the Leapwork application and the focus will be set to Local (Display 1). The test execution will start on Display 1 only.

   Note: In case there is an active window on screen 2, the focus will automatically shift to screen 2, thereby making the image recognition on screen 1 fail. In this case, ensure that there is no active window on screen 2 when the test starts.
2. Leapwork is running on Local (Display 2) and the Preview environment is set to Local (Display 2)

   When a user clicks the Run button from the Preview environment, the test will start by minimizing the Leapwork application and the focus will be set to Local (Display 2). The test execution will start on Display 2 only.

   Note: In case there is an active window on screen 1, the focus will automatically shift to screen 1, thereby making image recognition on screen 2 fail. In this case, ensure that there is no active window on screen 1 when the test starts. 
3. Leapwork is running on Local (Display 1) and the Preview environment is set to Local (Display 2)

   In this case, the test will start without minimizing Leapwork, instead, Local Display 1 will be set to inactive and Local Display 2 will be set to active. Test execution and case execution will start on Display 2 only, following the same principle as mentioned earlier.

Note: This is a recent change in Leapwork's display behavior, ensuring that the video capture functionality always captures the screen of the application under test, for example, the active window. A user can switch in-between applications on different screens during run time using the Use UI Window block available under Desktop UI.  

For further clarification, contact our Priority Support.