Web Add-in Extensibility Developer Guide > UFT Test Object Schema > Introduction > Test Object Configuration XML Overview

Test Object Configuration XML Overview

This Help file describes the elements and attributes available for creating test object configuration XML content to be used with your UFT extensibility project.

In a test object configuration XML, you define the test object classes (for example, the test object methods they support, their identification properties, and so on).

In some environments, you can also create a definition for an existing test object class in the test object configuration XML. This definition is added to the existing definition of this test object class, affecting all test objects of this class. It is therefore not recommended to modify existing test object classes in this way. For example:

In the test object configuration XML file, you create a ClassInfo element for each test object class that you want to define. In addition, you define the name of the environment or custom toolkit for which the test object classes are intended (in the PackageName attribute of the TypeInformation element), and the UFT add-in which these test object classes extend (in the AddinName attribute of the TypeInformation element).

If the relevant add-in is not loaded when UFT opens, UFT does not load the information in this XML. Similarly, if the name of the environment or custom toolkit is displayed in the Add-in Manager dialog box and its check box is not selected, the information in this XML is not loaded.

To ensure the structural correctness of your test object configuration file, you can validate it against the ClassesDefintions.xsd file. This file is installed with UFT, in the <UFT installation folder>\dat folder, and may be installed in additional locations when you install certain UFT add-in extensibility SDKs. (For backward compatibility reasons, UFT still supports certain XML structures that do not pass validation against this XSD.)

For more information, see How UFT Loads the Test Object Configuration XML.

The sections below describe the information that you can include in a test object class definition.

Class Name and Base Class

The name of the test object class and its attributes, including the base class—the test object class that the new test object class extends (relevant only when defining new test object classes).

The test object class name must be unique among all of the environments whose support a UFT user might load simultaneously. For example, when defining a new test object class, do not use names of test object classes from existing UFT add-ins, such as JavaButton, JavaEdit, etc.

Note:

  • A test object class inherits the base class' test object operations (methods and properties), generic type, default operation, and icon. Identification properties are inherited only by .NET test object classes.
  • If you create test object classes that extend test object classes defined in another toolkit support set, you create a dependency between the two toolkit support sets. Whenever you select to load the extending toolkit support set in the UFT Add-in Manager, you must also select to load the toolkit support set that it extends.
  • Generic Type

    The generic type for the test object class, if you are defining a new test object class and you want the new test object class to belong to a different generic type than the one to which its base class belongs. (For example, if your new test object class extends JavaObject (whose generic type is object), but you would like UFT to group this test object class with the edit test object classes.)

    Generic types are used when filtering objects (for example, in the Step Generator's Select Object for Step dialog box and when adding multiple test objects to the object repository). Generic types are also used when creating documentation strings for the Documentation column of the Keyword View (if they are not specifically defined in the test object configuration file).

    Test Object Operations

    A list of operations for the test object class, including the following information for each operation:

    Default Operation

    The test object operation that is selected by default in the Keyword View and Step Generator when a step is generated for an object of this class.

    Identification Properties

    A list of identification properties for the test object class. You can also define:

    Icon File

    The path of the icon file to use for this test object class (Optional. If not defined, the base class' icon is used.) The file can be a .dll, .exe, or .ico file.

    Help File

    A context-sensitive Help topic to open when F1 is pressed for the test object in the Keyword View or Editor. The definition includes the .chm Help file path and the relevant Help ID within the file.