Working With the TestedApps Editor

Applies to TestComplete 14.0, last modified on January 23, 2019

This topic provides information on tasks that can be accomplished with the TestedApps editor.

Adding New Tested Applications
  • Right-click anywhere within the TestedApps editor and choose Add Application from the context menu.

  • In the ensuing Add Tested Application wizard, choose the type of your tested application and specify its launch parameters.

For detailed information on adding items to the tested applications list, see the following topics:

Editing Tested Application Parameters

To modify parameters of a tested application:

  • Select the desired application in the list.

  • In the Basic Parameters section of the editor, modify basic parameters of the application.

  • In the Run-Mode Parameters section of the editor, modify parameters of the application applied to the selected application’s run mode.

  • Save the changes.
Renaming Tested Applications
  • Select the desired application in the list.

  • In the Name edit box of the Basic Parameters section of the editor, type the new application’s name.

  • Save the changes.

Note: The name of a tested application item is used to address the item in scripts and keyword tests. If you rename an application in the TestedApps editor, TestComplete automatically updates the Run TestedApp operations that launch the renamed application in your keyword tests. If you have script code or other keyword test operations that use the renamed item, you need to update them manually.
Specifying Application Run Mode

TestComplete can launch Windows-based applications under test in several run modes: Simple, RunAs, Debug, and Profile. To specify the tested application’s run mode:

  • Select the desired application in the list.

  • In the Basic Parameters section of the editor, select the needed run mode from the Run-Mode list.

  • In the Run-Mode Parameters section of the editor, specify parameters for the selected run mode.

  • Save the changes.

For more information about tested application types and run modes, see Run Modes and Parameters. For a description of tested application parameters, see Run Modes and Parameters.

Specifying Application Command Line and Working Folder

You can only modify command line and working folder settings for an application under test if the application is launched in the Simple, RunAs or Debug mode or if it is launched in the Java or AIR mode. If the application is launched in the Web mode, you can specify the command line for a web browser in which your web application under test will be opened. If the application is launched in the Profile mode, the command line and working folder settings are determined by the AQtime project.

To specify the command-line or working folder settings:

  • Select the desired application in the list.

  • If the application under test is Windows-based, make sure that its run mode is set to Simple, RunAs or Debug.

  • In the Run-Mode Parameters section of the editor, specify the desired command line or working folder settings in the appropriate edit boxes.

  • Save the changes.

The command line arguments are displayed in the footer area of the editor.

Running Applications Under Other User Accounts
  • Select the desired application in the tested applications list.

  • In the Basic Parameters section of the editor, select RunAs from the Run-Mode list.

  • In the Run-Mode Parameters section of the editor, specify the user name, domain, password and working folder settings for the run.

  • Save the changes.

  • Make sure the Launch application from tests check box in the Basic Parameters section of the editor is selected.

Now, when you launch an application from TestComplete, the application will be launched under the specified user account. See Testing Applications Running Under Another User Account for more information on this.

Running Applications Under AQtime

You can modify the tested application properties so that when you launch the application from TestComplete, it will run AQtime and execute the application under it. This way the application will be tested by TestComplete and profiled by AQtime at the same time.

To specify that the application should be run under AQtime:

  • Select the desired application in the tested applications list.

  • In the Basic Parameters section of the editor, select Profile from the Run-Mode list.

  • In the Run-Mode Parameters section of the editor, specify parameters for the run, for example, the profiler you want to use, the name of the AQtime project and so on. For detailed information on parameters you can configure, see Profile Mode Parameters.

  • Save the changes.

Now, when you launch an application from TestComplete (from the TestedApps editor, from script code or from your keyword test), TestComplete will run AQtime and launch the application from it. For more information, see Integration With AQtime.

Launching a Tested Application
  • Right-click the desired application in the tested applications list.

  • Select Run Selected from the context menu.

The application will be launched in the mode specified by its Run-Mode parameter. TestComplete will launch as many instances of the tested application as specified by its Count parameter (the Count parameter is ignored if an application is run in the Debug or Profile run mode or if the application is launched on a mobile device).

For information on how to launch the tested application from scripts, see Working With Tested Applications in Tests.

To launch a tested application from a keyword test, use the Run TestedApp operation.

Launching All Tested Applications
  • Select Run All from the TestedApps editor’s context menu.

The tested applications will be launched in the mode specified by their Run-Mode parameter. If the run mode is set to Simple or RunAs, TestComplete will launch as many instances of each tested application as specified by its Count parameter. If the run mode is Debug, TestComplete ignores the Count value and always launches one new application instance. If the run mode is Profile, TestComplete also ignores the Count value and launches the application under AQtime.

To learn how to launch tested applications from scripts, see Working With Tested Applications in Tests.

If you want to launch all tested applications from your keyword test, simply add the Run TestedApp keyword operation to the keyword test and select All Applications from the list of tested applications in the operation’s properties.

Deleting Applications From the List
  • Select the desired application in the tested applications list.

  • Right-click the application and select Delete from the context menu or press Del.

Saving the Changes

To save changes made to the tested applications list, select File | Save from the TestComplete main menu.

To discard any changes, close the editor and click No when TestComplete asks if you want to save the changes.

See Also

About TestedApps Editor
About Tested Applications
Run Modes and Parameters
Testing Applications Running Under Another User Account
Integration With AQtime
Working With Tested Applications in Tests
About Tested Android Applications

Highlight search results