Description
A tested application can be run in Profile mode. In this mode, TestComplete launches AQtime and then starts the application under AQtime. To do this, TestComplete can create a new AQtime project and add the tested application to it, or it can use an existing AQtime project. The UseProject property specifies whether TestComplete uses an existing project.
The UseProject property is the same as the Use AQtime project value specified for the application in the Tested Applications editor.
Declaration
TestedAppProfileParamsObj.UseProject
| Read-Write Property | Boolean |
| TestedAppProfileParamsObj | An expression, variable or parameter that specifies a reference to a TestedAppProfileParams object | |||
Applies To
The property is applied to the following object:
Property Value
True, if TestComplete uses an existing AQtime project. False, if TestComplete should load the tested application into a new AQtime project.
Remarks
To specify the desired AQtime project, use the TestedAppProfileParams.ProjectFileName property.
If you assign a value to this property, TestComplete will treat your project as modified. So, you will need to save or cancel changes when closing the project. The specified value will be displayed in the TestedApps editor.
Example
The following example demonstrates how to modify the tested application’s parameters in script:
JavaScript, JScript
function Test()
{
var testApp = TestedApps.Items("SampleApp");
// Obtain the tested application's parameters
var params = testApp.Params;
// Obtain the Profile run mode's parameters
var profileParams = params.ProfileParams;
// Specify the AQtime version
profileParams.AQtimeVersion = 8;
// Specify that TestComplete will use an AQtime project to profile the tested application
profileParams.UseProject = true;
// Specify the path to the AQtime project that TestComplete will use
profileParams.ProjectFileName = "D:\\Work Folder\\Sample.aqt";
// Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams.ForceRunMode = true;
// Specify the AQtime run mode during profiling
profileParams.RunMode = "Normal";
// Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams.OverrideProfiler = true;
// Specify the name of the AQtime profiler that will be used to profile the application
profileParams.ProfilerName = "Performance Profiler";
// Apply the modified parameters and activate the Profile run mode
profileParams.Activate();
// Launch the tested application
var AQtimeObj = testApp.Run();
// Simulate user actions against the tested application
// …
// Wait until profiling is over and export the profiling results
AQtimeObj.WaitAndExportResults("D:\\Work Folder\\SummaryResultsFile.xml", "D:\\Work Folder\\ResultsFile.xml");
}
{
var testApp = TestedApps.Items("SampleApp");
// Obtain the tested application's parameters
var params = testApp.Params;
// Obtain the Profile run mode's parameters
var profileParams = params.ProfileParams;
// Specify the AQtime version
profileParams.AQtimeVersion = 8;
// Specify that TestComplete will use an AQtime project to profile the tested application
profileParams.UseProject = true;
// Specify the path to the AQtime project that TestComplete will use
profileParams.ProjectFileName = "D:\\Work Folder\\Sample.aqt";
// Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams.ForceRunMode = true;
// Specify the AQtime run mode during profiling
profileParams.RunMode = "Normal";
// Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams.OverrideProfiler = true;
// Specify the name of the AQtime profiler that will be used to profile the application
profileParams.ProfilerName = "Performance Profiler";
// Apply the modified parameters and activate the Profile run mode
profileParams.Activate();
// Launch the tested application
var AQtimeObj = testApp.Run();
// Simulate user actions against the tested application
// …
// Wait until profiling is over and export the profiling results
AQtimeObj.WaitAndExportResults("D:\\Work Folder\\SummaryResultsFile.xml", "D:\\Work Folder\\ResultsFile.xml");
}
Python
def Test():
testApp = TestedApps.Items["SampleApp"]
# Obtain the tested application's parameters
params = testApp.Params
# Obtain the Profile run mode's parameters
profileParams = params.ProfileParams
# Specify the AQtime version
profileParams.AQtimeVersion = 8
# Specify that TestComplete will use an AQtime project to profile the tested application
profileParams.UseProject = True
# Specify the path to the AQtime project that TestComplete will use
profileParams.ProjectFileName = "D:\\Work Folder\\Sample.aqt"
# Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams.ForceRunMode = True
# Specify the AQtime run mode during profiling
profileParams.RunMode = "Normal"
# Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams.OverrideProfiler = True
# Specify the name of the AQtime profiler that will be used to profile the application
profileParams.ProfilerName = "Performance Profiler"
# Apply the modified parameters and activate the Profile run mode
profileParams.Activate()
# Launch the tested application
AQtimeObj = testApp.Run()
# Simulate user actions against the tested application
# ...
# Wait until profiling is over and export the profiling results
AQtimeObj.WaitAndExportResults("D:\\Work Folder\\SummaryResultsFile.xml", "D:\\Work Folder\\ResultsFile.xml")VBScript
Sub Test
Set testApp = TestedApps.Items("SampleApp")
' Obtain the tested application's parameters
Set params = testApp.Params
' Obtain the Profile run mode's parameters
Set profileParams = params.ProfileParams
' Specify the AQtime version
profileParams.AQtimeVersion = 8
' Specify that TestComplete will use an AQtime project to profile the tested application
profileParams.UseProject = True
' Specify the path to the AQtime project that TestComplete will use
profileParams.ProjectFileName = "D:\Work Folder\Sample.aqt"
' Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams.ForceRunMode = True
' Specify the AQtime run mode during profiling
profileParams.RunMode = "Normal"
' Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams.OverrideProfiler = True
' Specify the name of the AQtime profiler that will be used to profile the application
profileParams.ProfilerName = "Performance Profiler"
' Apply the modified parameters and activate the Profile run mode
profileParams.Activate
' Launch the tested application
Set AQtimeObj = testApp.Run
' Simulate user actions against the tested application
' …
' Wait until profiling is over and export the profiling results
Call AQtimeObj.WaitAndExportResults("D:\Work Folder\SummaryResultsFile.xml", "D:\Work Folder\ResultsFile.xml")
End Sub
Set testApp = TestedApps.Items("SampleApp")
' Obtain the tested application's parameters
Set params = testApp.Params
' Obtain the Profile run mode's parameters
Set profileParams = params.ProfileParams
' Specify the AQtime version
profileParams.AQtimeVersion = 8
' Specify that TestComplete will use an AQtime project to profile the tested application
profileParams.UseProject = True
' Specify the path to the AQtime project that TestComplete will use
profileParams.ProjectFileName = "D:\Work Folder\Sample.aqt"
' Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams.ForceRunMode = True
' Specify the AQtime run mode during profiling
profileParams.RunMode = "Normal"
' Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams.OverrideProfiler = True
' Specify the name of the AQtime profiler that will be used to profile the application
profileParams.ProfilerName = "Performance Profiler"
' Apply the modified parameters and activate the Profile run mode
profileParams.Activate
' Launch the tested application
Set AQtimeObj = testApp.Run
' Simulate user actions against the tested application
' …
' Wait until profiling is over and export the profiling results
Call AQtimeObj.WaitAndExportResults("D:\Work Folder\SummaryResultsFile.xml", "D:\Work Folder\ResultsFile.xml")
End Sub
DelphiScript
procedure Test();
var testApp, params, profileParams, AQtimeObj;
begin
testApp := TestedApps.Items('SampleApp');
// Obtain the tested application's parameters
params := testApp.Params;
// Obtain the Profile run mode's parameters
profileParams := params.ProfileParams;
// Specify the AQtime version
profileParams.AQtimeVersion := 8;
// Specify that TestComplete will use an AQtime project to profile the tested application
profileParams.UseProject := true;
// Specify the path to the AQtime project that TestComplete will use
profileParams.ProjectFileName := 'D:\Work Folder\Sample.aqt';
// Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams.ForceRunMode := true;
// Specify the AQtime run mode during profiling
profileParams.RunMode := 'Normal';
// Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams.OverrideProfiler := true;
// Specify the name of the AQtime profiler that will be used to profile the application
profileParams.ProfilerName := 'Performance Profiler';
// Apply the modified parameters and activate the Profile run mode
profileParams.Activate;
// Launch the tested application
AQtimeObj := testApp.Run;
// Simulate user actions against the tested application
// …
// Wait until profiling is over and export the profiling results
AQtimeObj.WaitAndExportResults('D:\Work Folder\SummaryResultsFile.xml', 'D:\Work Folder\ResultsFile.xml');
end;
var testApp, params, profileParams, AQtimeObj;
begin
testApp := TestedApps.Items('SampleApp');
// Obtain the tested application's parameters
params := testApp.Params;
// Obtain the Profile run mode's parameters
profileParams := params.ProfileParams;
// Specify the AQtime version
profileParams.AQtimeVersion := 8;
// Specify that TestComplete will use an AQtime project to profile the tested application
profileParams.UseProject := true;
// Specify the path to the AQtime project that TestComplete will use
profileParams.ProjectFileName := 'D:\Work Folder\Sample.aqt';
// Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams.ForceRunMode := true;
// Specify the AQtime run mode during profiling
profileParams.RunMode := 'Normal';
// Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams.OverrideProfiler := true;
// Specify the name of the AQtime profiler that will be used to profile the application
profileParams.ProfilerName := 'Performance Profiler';
// Apply the modified parameters and activate the Profile run mode
profileParams.Activate;
// Launch the tested application
AQtimeObj := testApp.Run;
// Simulate user actions against the tested application
// …
// Wait until profiling is over and export the profiling results
AQtimeObj.WaitAndExportResults('D:\Work Folder\SummaryResultsFile.xml', 'D:\Work Folder\ResultsFile.xml');
end;
C++Script, C#Script
function Test()
{
var testApp = TestedApps["Items"]("SampleApp");
// Obtain the tested application's parameters
var params = testApp["Params"];
// Obtain the Profile run mode's parameters
var profileParams = params["ProfileParams"];
// Specify the AQtime version
profileParams["AQtimeVersion"] = 8;
// Specify that TestComplete will use an AQtime project to profile the tested application
profileParams["UseProject"] = true;
// Specify the path to the AQtime project that TestComplete will use
profileParams["ProjectFileName"] = "D:\\Work Folder\\Sample.aqt";
// Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams["ForceRunMode"] = true;
// Specify the AQtime run mode during profiling
profileParams["RunMode"] = "Normal";
// Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams["OverrideProfiler"] = true;
// Specify the name of the AQtime profiler that will be used to profile the application
profileParams["ProfilerName"] = "Performance Profiler";
// Apply the modified parameters and activate the Profile run mode
profileParams["Activate"]();
// Launch the tested application
var AQtimeObj = testApp["Run"]();
// Simulate user actions against the tested application
// …
// Wait until profiling is over and export the profiling results
AQtimeObj["WaitAndExportResults"]("D:\\Work Folder\\SummaryResultsFile.xml", "D:\\Work Folder\\ResultsFile.xml");
}
{
var testApp = TestedApps["Items"]("SampleApp");
// Obtain the tested application's parameters
var params = testApp["Params"];
// Obtain the Profile run mode's parameters
var profileParams = params["ProfileParams"];
// Specify the AQtime version
profileParams["AQtimeVersion"] = 8;
// Specify that TestComplete will use an AQtime project to profile the tested application
profileParams["UseProject"] = true;
// Specify the path to the AQtime project that TestComplete will use
profileParams["ProjectFileName"] = "D:\\Work Folder\\Sample.aqt";
// Specify that TestComplete sets the AQtime run mode after profiling starts
profileParams["ForceRunMode"] = true;
// Specify the AQtime run mode during profiling
profileParams["RunMode"] = "Normal";
// Specify that TestComplete uses the profiler specified in the TestComplete project
profileParams["OverrideProfiler"] = true;
// Specify the name of the AQtime profiler that will be used to profile the application
profileParams["ProfilerName"] = "Performance Profiler";
// Apply the modified parameters and activate the Profile run mode
profileParams["Activate"]();
// Launch the tested application
var AQtimeObj = testApp["Run"]();
// Simulate user actions against the tested application
// …
// Wait until profiling is over and export the profiling results
AQtimeObj["WaitAndExportResults"]("D:\\Work Folder\\SummaryResultsFile.xml", "D:\\Work Folder\\ResultsFile.xml");
}
See Also
ProjectFileName Property
OverrideProfiler Property
ForceRunMode Property
About Tested Applications
Run Modes and Parameters
Editing Desktop Application Parameters
Integration With AQtime