Adding Tested Applications

While creating a project

While creating a test

From the TestedApps editor

From the Object Browser (for desktop Windows applications only)

During test recording (for desktop and web applications)

From tests

By copying existing tested applications in the project

When you are adding a new project with the Create New Project Wizard at design time, TestComplete asks you to choose the application to be tested, specify the application’s parameters and then adds this application to the list of tested applications.

When you start test recording with the Record Test wizard, TestComplete asks you to select the application for which you will record the test. TestComplete will add the application to the list of tested applications and start recording.

• Right-click somewhere within the Tested Apps editor and select  Add Application from the context menu.

  -- or --

  Right-click the TestedApps node in the Project Explorer panel and select  New Item from the context menu.

• The Add Tested Application wizard will appear. Follow the wizard instructions to add the desired application to the project.

To learn how to add various types of tested applications, see:

• Right-click the application’s process (or any of its child objects) in the Object Browser’s Object Tree and select  Add Process to TestedApps from the context menu.

When you launch a generic Windows application during test recording, TestComplete can automatically add that application to the Tested Applications collection of your project.

You can control this behavior by using the Automatically add applications to the Tested Applications list and Show 'Add <ApplicationName> to the list of tested applications?' message options.

You can add applications to the Tested Applications collection and define their properties directly from your tests. To do this, use the following methods of the TestedApps scripting object:

• To add a desktop Windows application to your project, use the TestedApps.Add method.

  Note:

  The Add method specifies the Simple run mode for the added application. To specify the RunAs, Profile or Debug mode for the added application, you can use the Params property of the TestedApps object.

• To add an AIR application to your project, use the TestedApps.AddAIRApp method.

• To add a Java application to your project, use the TestedApps.AddJavaApp method.

• To add a Java Web Start application (for example, an Oracle Forms application running out-of-browser) to your project, use the TestedApps.AddJavaWebStartApp method.

• To add an Android application, use the TestedApps.AddAndroidApp method.

• To add an iOS application, use the TestedApps.AddiOSApp method.

• To add a Web application to the list of tested applications, use the TestedApps.AddBrowser method.

• To add a ClickOnce application to the list of tested applications, use the TestedApps.AddClickOnceApp method.

• To add a Windows Store application to the list of tested applications, use the TestedApps.AddWinStoreApp method.

The following sample code demonstrates how you can use the TestedApps.Add method to add Notepad to the Tested Applications collection:

def AddTestedApp():
  
  # Add Notepad to Tested Applications
  ind = TestedApps.Add("%WINDIR%\\notepad.exe");
  Log.Message(aqString.Format('Notepad was added to TestedApps under the name "%s" and index %d.',\
              TestedApps.Items[ind].ItemName, ind) )

  # Launch Notepad
  TestedApps.Items[ind].Run()

To define a tested application from keyword tests, call the described method by using the Call Object Method or Run Code Snippet operation.

• Right-click the desired item in the Tested Apps editor and select Copy from its context menu.

• Right-click somewhere within the editor and select Paste from the context menu.

-- or --

• Select the desired item in the Tested Apps editor and choose Edit | Copy from the TestComplete main menu.

• Select Edit | Paste from the main menu to paste the copied object to the editor.

After the new item appears in the tested application’s list, you can modify its properties, for example, the command-line parameters, the run mode and others.