Custom Support Test Object Identification Properties Screen

This topic describes the Custom Support Test Object Identification Properties screen in the New Custom Support Class Wizard, where you choose which identification properties to inherit, override, or add for your support class.

Overview

Use this screen to decide which identification properties are inherited, which are overridden, and which new properties are introduced for the selected mapping. These choices affect both the generated support methods and, when relevant, the test object class definition.

Wizard map

Custom Class Selection Screen > Test Object Class Selection Screen > Custom Support Test Object Identification Properties Screen > Custom Support Test Object Methods Screen > Custom Control Recording Support Screen > New Test Object Class Details Screen > Custom Control Support Class Summary Screen

Screen details

The Custom Support Test Object Identification Properties screen displays the identification properties supported by the base support class you are extending, as well as additional properties that are defined in the test object class you selected, but are not yet supported.

Properties Inherited from Base Support Class

The left pane displays all of the identification properties implemented by the base support class. These are the identification properties that will be inherited by the support class you are creating. You can select any identification properties whose support you want to override with a different implementation.

Note: Some of these identification properties are not included in the test object class definition. Therefore, they are not displayed in OpenText Functional Testing in the Object Spy or in the Checkpoint Properties dialog box. You can access those identification properties by using the GetROProperty method. For more information on the GetROProperty method, see the Object Model Reference.

When the wizard creates the support class file, it adds a support method stub, named <identification property name>_attr, for each of the identification properties you select. The support method stubs return the same values as the support methods in the base support class. You can implement the new support methods to match the needs of your custom control.

Additional Properties Required for Test Object Class

The right pane displays the identification properties that are defined in the test object class you selected, but are not supported by the base support class. You can modify this list using the Add, Remove, and Modify buttons.

For each of the identification properties in this pane, the wizard adds a support method stub to the support class it creates. The support method stubs return null until you implement them to match the needs of your custom control.

If you add identification properties to this list, the wizard adds them to the test object class definition in the test object configuration file. For information on the structure and content of this file, see the Test Object Schema Help.

Note: If you selected the Same as base support class option in the Test Object Class Selection Screen, the wizard does not know which test object class is mapped to the custom control. As a result, no identification properties are displayed in the right pane. If you add an identification property, the wizard adds the appropriate support method stub to the support class it creates. However, the identification property is not added to any test object class definition.

Considerations for Adding and Removing Properties from the List

  • If you add identification properties to this list, they are added to the test object class definition. This means that the new properties appear in the list of identification properties in OpenText Functional Testing for all test objects of this class.

    Therefore, if you plan to add properties, it is recommended to create a new test object class based on the existing one, instead of using the existing test object class.

  • If you remove an identification property from the list, it is no longer supported for this custom class. However, it is still part of the test object class definition. Therefore, although it still appears in the list of identification properties shown in the OpenText Functional Testing Object Spy, it will have no value.

  • Modifying an identification property is equivalent to removing it and adding a new one.

Managing the List of Identification Properties

The procedures below describe how to add, remove, and modify identification properties in the list of additional properties required for the test object class.

To add an identification property:

  1. In the Additional properties required for test object class pane, click Add. The Identification Property dialog box opens.

  2. Enter a name for the new identification property and click OK. (The identification property name must begin with a letter and contain only alphanumeric characters and underscores.)

To remove an identification property:

  1. In the Additional properties required for test object class pane, select the property you want to remove.

  2. Click Remove. Then click Yes to confirm.

To modify an identification property:

  1. In the Additional properties required for test object class pane, select the property you want to rename.

  2. Click Modify. The Identification Property dialog box opens.

  3. Modify the identification property name and click OK.

    4. Tip: To add identification properties after the support class is created, use the Add Identification Property button or select UFT > Add Identification Property in Eclipse.

Next steps