Automation Object Model Overview

Description

The UFT One automation object model exposes the objects shown in the diagram below.

You can use these objects, and their associated methods and properties, to write programs that automatically configure UFT One options and run tests.

Object model diagram

Click an object in the diagram below to view information and examples for that object.

Object Model

Classes

Class ModuleDescription

AAFunctionLibraries

(UFT One version 2022 and later)

A collection that represents the top part of the Resources pane of the Application Area Settings dialog box.

ActionA test action.
ActionParameterDefinitionThe definition of an individual action parameter.
ActionParameterDefinitionsA collection of ActionParameterDefinition objects.
ActionsA collection of Action objects.
ActiveScreenAccessRepresents the Active Screen access area in the Web pane of the Test Settings dialog box, which enable you to specify the user details used to log into password-protected Active Screen pages.
ActiveScreenOptionsRepresents the GUI Testing tab > Active Screen pane of the Options dialog box, which enables you to specify how much information is saved in the Active Screen for all tests and business components.
AddinRepresents a UFT One Add-in.
AddinsA collection of Addin objects.
AdditionalIdentificationPropertiesA collection representing the list of assistive or optional filter properties from the Object Identification or Smart Identification Properties dialog box.

APITest

(UFT One version 2021 and later)

An API test.

APITests

(UFT One version 2021 and later)

A collection of API tests.

AppArea

(UFT One version 2022 and later)

The open application area.
Application

You can create only one instance of this object. Use this object to return other UFT One objects and to perform application level operations such as loading add-ins, creating or opening tests, and launching or closing the UFT One application.

AutoExportReportConfigOptionsRepresents the Configure Automatic Export of Run Results dialog box, which enables you to configure export run results options.
AvailablePropertiesRepresents the Add/Remove Properties dialog box, which enables you to modify the list of properties in the mandatory, assistive, base filter, or optional filter properties lists.
DataTable

Represents the UFT One runtime or design-time data table and its associated sheets and parameters, depending on whether the object was returned from LastRunResults.DataTable or Test.DataTable.

DLConnection

(UFT One version 23.4 and later)

Represents the Digital Lab connection settings pane in the Options dialog box, and determines property values for connecting to Digital Lab from UFT One.

Environment

Represents the UFT One Environment object, which enables you to set or retrieve the value of environment variables.

For more information, see Environment object:QTReservedObjects.chm:.

FlexApplicationThe details of a single Flex application to be opened by the FlexLauncher object.
FlexApplicationsA collection of FlexApplication objects, each containing details for a single application to be opened by the FlexLauncher.
FlexLauncherRepresents the Flex tab of the Record and Run Settings dialog box, which determines which Flex applications to open (if any) when a record or run session begins.
FoldersOptionsYou use this object both for configuring the folders search list and for finding (resolving) relative paths.
JavaDeviceReplayRepresents the mouse/keyboard operation options in the Java pane of the Test Settings or Business Component Settings dialog box, which enable you to control whether operations are performed using device replay.
JavaEditSetModeRepresents the JavaEdit.Set options in the Java pane of the Test Settings or Business Component Settings dialog box, which enable you to control how operations are performed on edit fields.
JavaLauncherRepresents the Java tab of the Record and Run Settings dialog box, which determines which Java application or applet to open (if any) when a record or run session begins.
JavaOptionsRepresents the GUI Testing tab > Java pane of the Options dialog box, which enables you to configure how UFT One records and runs steps on Java applets and applications.
JavaSettingsRepresents the Java pane of the Test Settings or Business Component Settings dialog box, which enables you to configure how UFT One records and runs steps on Java applets and applications.
LastRunResultsContains the data of the most recent run results.
LaunchersA collection of Launcher objects, which enable you to specify which applications to open when a record or run session begins.
LocalSystemMonitorSettingsRepresents the Local System Monitor pane of the Test Settings dialog box, which enables you to define the system counters to be used for the test.
LogTrackingSettingsRepresents the Log Tracking pane of the Test Settings or Business Component Settings dialog box, which enables you to configure your log tracking and collection preferences.
MainIdentificationPropertiesA collection representing the list of mandatory or base filter properties from the Object Identification or Smart Identification Properties dialog box.

MCConnection

Represents the Mobile Add-in connection settings pane in the Options dialog box, and determines property values for connecting to Mobile Center / UFT Mobile / Digital Lab from UFT One.

Note: Starting from UFT One 23.4, this object is supported only for backward compatibility.

MobileAppRepresents a specific mobile app defined in the Mobile tab of the Record and Run Settings dialog box.
MobileAppsA collection representing the list of mobile apps defined in the Mobile tab of the Record and Run Settings dialog box.
MobileDeviceRepresents a device used during a record or run session.
MobileLauncherRepresents the Mobile tab of the Record and Run Settings dialog box.
ObjectIdentificationA collection that represents the Object Identification dialog box, which enables you to configure the properties that UFT One learns for each test object class.
ObjectRepositoriesA collection that represents the Associated Repository Files tab of the Action Properties dialog box, which enables you to specify the object repository files associated with the current action.
OptionsRepresents the GUI Testing tab of the Options dialog box and other tools that enable you to configure options that apply to all GUI tests and business components.
OracleLauncherRepresents the Oracle tab of the Record and Run Settings dialog box, which enables you to specify which Oracle session to open (if any) when a record or run session begins.
ParameterA test or component parameter that is supplied and used during a run session.
ParameterDefinitionThe definition of an individual test or component parameter.
ParameterDefinitionsA collection of ParameterDefinition objects.
ParametersA collection of Parameter objects.
RecoveryRepresents the Recovery pane of the Test Settings or Business Component Settings dialog box, which enables you to configure which recovery scenarios to associate with a test or business component.
RecoveryScenarioA Recovery Scenario, associated with the current test or business component.
ResourcesRepresents the lower part of the Resources pane of the Test Settings dialog box, which enables you to set the external resources associated with your test.

Resources (for AppArea)

(UFT One 2022 or later)

Represents the top part of the Resources pane of the Application Area Settings dialog box, which enables you to specify the function library files associated with the current application area.

RunOptionsRepresents options in the General > Run Sessions pane, the GUI Testing > Test Runs pane, and the GUI Testing > Screen Capture pane of the Options dialog box, which enable you to set Run options for all tests and business components.
RunResultsOptionsA collection of properties that indicate preferences for the run results.
RunSettingsRepresents the Run pane of the Test Settings dialog box, which enables you to set the values of the run settings.
SAPLauncherRepresents the SAP tab of the Record and Run Settings dialog box, which enables you to specify which SAP session to open (if any) when a record or run session begins.
SAPOptionsRepresents the GUI Testing tab > SAP node > General pane of the Options dialog box, which enables you to to configure how UFT One records and runs steps on SAP applications.
ScreenRecorderOptionsRepresents the GUI Testing tab > Screen Capture pane of the Options dialog box, which enables you to configure how Screen Recorder movies are captured.
SiebelLauncherRepresents the Siebel tab of the Record and Run Settings dialog box, which enables you to specify which Siebel session to open (if any) when a record or run session begins.
StdApplicationThe details of a single Windows application to be opened by the StdLauncher object.
StdApplicationsA collection of StdApplication objects, each containing details for a single application to be opened by the StdLauncher.
StdLauncherRepresents the Windows Applications tab of the Record and Run Settings dialog box, which enables you to specify on which applications to record and run the test, or to record and run on any Windows application.
SystemCounterA system counter definition.
SystemCountersA collection of SystemCounter objects.
TDConnectionAn object that enables you to manage the ALM connection and retrieve the TDOTA object, which provides full interaction with ALM.
TDOTA

Using the ALM Open Test Architecture (previously TDOTA), you can integrate your own requirement and configuration management tools, defect tracking tools, third-party and custom tools, and modeling applications.

You can:

  • Remotely execute tests in your testing application on multiple hosts across a network and analyze the run results from within the ALM environment.
  • Use the ALM COM-based API to enable your application to create, retrieve, and update ALM project records from within your test application environment.

For more information, refer to the ALM Open Test Architecture API Reference, which is supplied with your ALM package.

TEOptionsRepresents the GUI Testing tab > Terminal Emulator pane of the Options dialog box, which enables you to configure how UFT One records and runs steps on terminal emulator applications.
TestThe open test or business component.
TestLibrariesA collection that represents the top part of the Resources pane of the Test Settings or Business Component Settings dialog box, which enables you to specify the function library files associated with the current test or component.
TestObjectClassIdentificationRepresents the object class configuration options of the Object Identification dialog box.
TestSettingsUsed to configure many per-test settings, such as those in the Test Settings or Business Component Settings dialog box.
UpdateRunOptionsA collection of properties that indicate preferences for the Update Run.
WebActiveScreenRepresents the GUI Testing tab > Active Screen pane > Appearance (Web) area in the Options dialog box, which enables you to configure the way Web pages are displayed in the Active Screen for all Web-based tests or business components.
WebLauncherRepresents the Web tab of the Record and Run Settings dialog box, which determines which Web browser and URL to open (if any) when a record or run session begins.
WebOptionsRepresents options in the GUI Testing tab > Web node of the Options dialog box, which enable you to to configure how UFT One records and runs steps on Web-based applications.
WebSettingsRepresents the Web pane of the Test Settings or Business Component Settings dialog box, which enable you to control options for recording and running tests on Web sites.
WindowsAppsOptionsRepresents the GUI Testing tab > Windows Applications node > General pane and the GUI Testing tab > Windows Applications node > Advanced pane of the Options dialog box, which enable you to configure how UFT One records and runs steps on Windows-based applications.

Public Enumerations