Profile Mode Parameters

Applies to TestComplete 15.45, last modified on December 01, 2022

The Profile mode is used to launch an application under AQtime. When you run your application under test in this mode, the application is profiled by AQtime and TestComplete performs testing operations (for instance, simulates user actions) with application windows. For more information, see Integration With AQtime.

Using the Profile mode requires that TestComplete be run with administrator permissions.

You can view and change Profile mode parameters in the TestedApps editor. The parameters are organized into two sections - Basic Parameters and Run-Mode Parameters.

Basic Parameters

Basic parameters include the following:

Parameter Description
Name The unique name of the tested application in the Tested Applications collection. This name is used to refer to the application in tests, for example, in the Run TestedApp keyword test operation.
Run Mode The mode in which TestComplete will launch the application:

  • Simple - The application will be launched using the command-line and the working folder specified in the Run-Mode Parameters section, under the same user account that TestComplete is running under. This is similar to how a user would launch the application directly via its executable or using the Start menu or desktop shortcut.

  • RunAs - The application will be launched under a specific user account. See Testing Applications Running Under Another User Account.

  • Debug - Similar to the Simple mode, but TestComplete additionally traces and logs all exceptions and events (debug strings, module loading and so on) that occur in the application’s process. See Tracing Events and Exceptions With Debug Services.

  • Profile - The application will be launched under the AQtime profiler. AQtime will analyze the application performance, memory leaks, resource usage or other characteristics. In other words, the application will be tested by TestComplete and profiled by AQtime at the same time. See Integration With AQtime for more information.
Count This parameter is ignored.
Autorun application on recording Select this option to have the application launched automatically when you start test recording.
Launch application from tests Uncheck this option to prevent the application from being launched by the Run TestedApp keyword test operation and the TestedApps.AppName.Run scripting method.

For example, you can define several instances of the tested application with different configurations and “disable” those not needed at the moment.

Run-Mode Parameters

The following parameters are specific to the Profile run mode:

Parameter Description
Application The name and path of the application executable file (.exe, .com, .bat or .cmd). You can enter the path manually or click the button and browse for the needed file.

The path can be fully-qualified or relative to the project folder. To switch between the fully-qualified and relative path representations, click the drop-down button and select the desired path in the drop-down list.

You can use environment variables, such as %PROGRAMFILES%, as well as project and project suite variables in the format $(VarName) in the file path. For more information, see Using Variables in Tested Application Paths.

If the application resides in a folder that is in the PATH environment variable, you can omit the application path and specify the file name only. For example, you can specify notepad.exe instead of C:\Windows\notepad.exe.

Note: The application path can be different on different computers. If you move the test project to other computers, the specified path may point to a non-existing location on those computers. To avoid the problem, it is recommended to install the application to a folder that is common to all test computers. You can also use environment, project or project suite variables in place of computer-specific path components. See Avoiding Computer-Specific Settings for more information.
Version If you have multiple versions of AQtime installed, use this combo box to select the version you wish to use. Supported AQtime versions are 4.7-8.x.
Profiler The AQtime profiler to use for the tested application. To refresh the profilers list, click Ger profilers.
Note: When using the Use AQtime project option, the profiler selection is ignored and TestComplete uses the profiler selected in the AQtime project. If you want to use a different profiler, select Override project profiler and choose the needed profiler from the Profiler combo box.
Run mode Specifies whether AQtime will display errors and warnings during the profiling session:

  • Silent - (Default) AQtime will not display any dialog boxes and messages during the run. If a dialog is displayed, the default processing will be applied.

  • Normal - AQtime will run in its normal mode as if you started profiling from it.

  • Errors and Warnings - AQtime will display error and warning messages that may be displayed during the profiling.

  • Errors only - AQtime will display error messages only.

If you select the Silent mode, you will not be able to use AQtime dialogs when analyzing results in AQtime. To use the dialogs, set the Run mode parameter to anything other than Silent.
Set Run mode after profiling starts By default, TestComplete changes AQtime’s run mode after the profiling is over. If you need to change the mode right after the profiling starts, select the Set Run mode after profiling starts check box. When starting profiling, AQtime may display various settings and informative dialogs and messages, so, you can select the check box to let your TestComplete tests simulate user actions over these dialogs and messages.
Use AQtime project If you have an AQtime project configured for application profiling, select this option and specify the Project file name.

If you do not specify an AQtime project, TestComplete will create a temporary AQtime project with the default profiling settings and delete this project after the profiling is over.
Project file name This option is used only if the Use AQtime project option is selected. It specifies the path to the AQtime project that will be used for application profiling. You can enter the project file name manually or click the button and browse for the desired project file.

To view or modify this project in AQtime, click Edit project.

The file path can include environment variables, such as %PROGRAMFILES%, as well as project and project suite variables in the format $(VarName). For more information, see Using Variables in Tested Application Paths.
Override project profiler This option is effective only if the Use AQtime project option is used.

If it is selected, TestComplete will use the AQtime profiler selected in the Profiler combo box rather than the one selected in the AQtime project. Otherwise, TestComplete will use the profiler specified in the AQtime project.

See Also

About Tested Applications
Integration With AQtime
TestedApps Editor
Run Modes and Parameters
Working With Tested Applications in Tests
Using Variables in Tested Application Paths

Highlight search results