[Collapse]TestComplete/viewarticle/32760/
 [Expand]General Information/viewarticle/32760/
 [Expand]Using Help System/viewarticle/27355/
 [Expand]Getting Started Tutorial/viewarticle/30932/
 [Collapse]Using TestComplete/viewarticle/28775/
  [Expand]TestComplete User Interface, Projects and Settings/viewarticle/31969/
  [Collapse]Creating, Recording and Running Tests/viewarticle/32203/
   [Expand]Naming Objects/viewarticle/27907/
   [Expand]Creating Tests/viewarticle/28212/
   [Expand]Managing Tested Applications/viewarticle/31408/
   [Expand]Checkpoints and Stores/viewarticle/29944/
   [Collapse]Running Tests/viewarticle/29647/
     Running Tests - Overview/viewarticle/27279/
     Terminating Tests on Timeout/viewarticle/28111/
     Scheduling TestComplete Runs/viewarticle/28538/
     Creating Batch Runs/viewarticle/30450/
    [Collapse]Running Tests via Remote Desktop/viewarticle/27110/
      Running Tests via Remote Desktop - Overview/viewarticle/27635/
      Running Tests in Minimized Remote Desktop Windows/viewarticle/30217/
      Disconnecting From Remote Desktop Session While Running Automated Tests/viewarticle/30747/
      Smart Resizing of Remote Desktop Windows/viewarticle/27448/
     Running Tests on Locked Computers/viewarticle/28270/
     Shutting Down and Restarting Computer After Test Run/viewarticle/32174/
     Rebooting Computer and Continuing Testing/viewarticle/30885/
     Using TestComplete Indicator/viewarticle/30646/
    [Expand]Running Tests - Tips/viewarticle/32096/
   [Expand]Handling Playback Errors/viewarticle/29300/
   [Expand]Keyword Testing/viewarticle/27536/
   [Expand]Scripting/viewarticle/31252/
   [Expand]Test Visualizer/viewarticle/32488/
   [Expand]Exploring Applications/viewarticle/31404/
   [Expand]Debugging Tests/viewarticle/27457/
  [Expand]Test Results/viewarticle/32031/
  [Expand]Enhancing Tests/viewarticle/27913/
  [Expand]Teamwork and Integration Into QA Process/viewarticle/27356/
  [Expand]Extending TestComplete/viewarticle/30232/
  [Expand]Automating TestComplete/viewarticle/32180/
 [Expand]Testing Types/viewarticle/28818/
 [Expand]Applications Testing/viewarticle/27794/
 [Expand]Working With Application Objects and Controls/viewarticle/30817/
 [Expand]Samples and Tutorials/viewarticle/29749/
 [Expand]References/viewarticle/26963/
 [Expand]Other Tools That Help You Test Better/viewarticle/42461/
 [Expand]TestComplete Licensing Guide/viewarticle/33802/
Updated: 6/10/2013 Applies To: TestComplete 9 Rating: GoodGoodGoodGoodGood 5 vote(s) Click to rate: PoorNot badAverageGoodExcellent
Running Tests via Remote Desktop

Running Tests in Minimized Remote Desktop Windows

The Microsoft Windows operating system includes the Remote Desktop component that allows you to connect to a remote computer and work with it as with your local computer.

Using Remote Desktop you can run and monitor automated tests on remote computers: you connect to the test computer using a Remote Desktop connection and use the Remote Desktop window to work with the remote computer on your PC. For more information on running automated tests by using the Remote Desktop component, see Running Tests via Remote Desktop - Overview.

However, if you minimize the Remote Desktop window (the window that display the remote computer’s desktop), the operating system switches the remote session to the GUI-less mode and does not display windows and controls. As a result, TestComplete (or TestExecute) is unable to interact with the tested application’s GUI, as the GUI does not actually exist in this case and your automated GUI test fails.

To avoid this issue, you can keep the Remote Desktop window visible during the test run, but this may be inconvenient as it occupies some part or even your entire screen and leaves less space for you to run your local applications.

There is another way to bypass this limitation. In order to run GUI tests on a remote computer while the Remote Desktop window is minimized, you need to change the Registry keys on the computer from which you connect to the remote TestComplete or TestExecute workstation. To do this, perform the following steps:

  • Log in to the computer from which you connect to remote computers (if you are not logged in yet).

  • Close all open Remote Desktop sessions.

  • Click Start and select Run. In the Run dialog box, type regedit and press Enter. The Registry Editor starts.

  • Navigate to one of the following Registry keys, depending on whether you wish to modify the Remote Desktop settings only for the current user or for all users on the computer:

    HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client

    HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client

  • Create a DWORD value named RemoteDesktop_SuppressWhenMinimized and set it to 2.

  • Close the Registry Editor.

Now when you minimize the Remote Desktop Connection window on your computer, this will not affect the remote computer’s GUI and the GUI will be available to your automated tests.

See also
Running Tests via Remote Desktop | Running Tests via Remote Desktop - Overview | Disconnecting From Remote Desktop Session While Running Automated Tests | Smart Resizing of Remote Desktop Windows | Running Tests | Running Tests on Locked Computers


© 2013 SmartBear Software. All rights reserved.
Email Send feedback on this document