[Expand]General Information/viewarticle/63445/
 [Expand]Using Help System/viewarticle/55799/
 [Expand]Getting Started Tutorial/viewarticle/56246/
 [Collapse]Using TestComplete/viewarticle/57875/
  [Expand]TestComplete User Interface, Projects and Settings/viewarticle/57876/
  [Collapse]Creating, Recording and Running Tests/viewarticle/56646/
   [Expand]Naming Objects/viewarticle/56265/
   [Expand]Creating Tests/viewarticle/57373/
   [Expand]Managing Tested Applications/viewarticle/57435/
   [Expand]Checkpoints and Stores/viewarticle/56266/
   [Collapse]Running Tests/viewarticle/56462/
     Running Tests - Overview/viewarticle/56553/
     Terminating Tests on Timeout/viewarticle/56564/
     Scheduling TestComplete Runs/viewarticle/56555/
     Creating Batch Runs/viewarticle/56561/
    [Collapse]Running Tests via Remote Desktop/viewarticle/55606/
      Running Tests via Remote Desktop - Overview/viewarticle/56549/
      Running Tests in Minimized Remote Desktop Windows/viewarticle/56551/
      Disconnecting From Remote Desktop Session While Running Automated Tests/viewarticle/56552/
      Smart Resizing of Remote Desktop Windows/viewarticle/56548/
     Running Tests on Locked Computers/viewarticle/56550/
     Shutting Down and Restarting Computer After Test Run/viewarticle/55428/
     Rebooting Computer and Continuing Testing/viewarticle/55089/
     Using TestComplete Indicator/viewarticle/55569/
    [Expand]Running Tests - Tips/viewarticle/56534/
   [Expand]Handling Playback Errors/viewarticle/56641/
   [Expand]Keyword Testing/viewarticle/55462/
   [Expand]Test Visualizer/viewarticle/55007/
   [Expand]Exploring Applications/viewarticle/55055/
   [Expand]Debugging Tests/viewarticle/56567/
  [Expand]Test Results/viewarticle/55010/
  [Expand]Enhancing Tests/viewarticle/56964/
  [Expand]Teamwork and Integration Into QA Process/viewarticle/57266/
  [Expand]Extending TestComplete/viewarticle/57655/
  [Expand]Automating TestComplete/viewarticle/57438/
   TestComplete Tips/viewarticle/57877/
 [Expand]Testing Types/viewarticle/62721/
 [Expand]Applications Testing/viewarticle/62606/
 [Expand]Working With Application Objects and Controls/viewarticle/55815/
 [Expand]Samples and Tutorials/viewarticle/56239/
 [Expand]Other Tools That Help You Test Better/viewarticle/63442/
 [Expand]TestComplete Licensing Guide/viewarticle/63451/
Updated: 3/11/2014 Applies To: TestComplete 10 Rating: GoodGoodGoodGoodGood 5 vote(s) Click to rate: PoorNot badAverageGoodExcellent
Running Tests via Remote Desktop

Running Tests in Minimized Remote Desktop Windows

Windows 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 work around the issue, you can change the Remote Desktop’s registry settings on your local computer (where you launch the Remote Desktop):

  • On your local computer, close all open Remote Desktop sessions.

  • Launch the Registry editor (regedit.exe).

    Note: On 64-bit versions of Windows, launch the 64-bit version of the Registry editor (for example, by selecting Start | Run and typing regedit).
  • 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

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