Designing Your Toolkit Configuration XML File

In this file, you map application controls to test objects and custom test object classes to existing UFT One tests objects.

  • Mapping application controls to test objects. You map the custom controls in your Delphi application to the Delphi test object classes that should represent them in UFT One tests and components. You can map custom controls to new Delphi test object classes that you define in the test object configuration file or to existing Delphi test object classes.

    Use new Delphi test object classes, if you want to customize the test object name, description (the set of properties UFT One uses to identify the object in the application), or any properties and methods that are specific to your control.

    Note: If you want to customize only how a certain test object method is performed on the control (and not the method syntax), you can map the control to the existing test object class. You can override the test object method implementation in the Agent Object that you develop.

    The same is true for identification properties—if a test object class includes an identification property that is relevant for your control but UFT One does not retrieve its value, you can design your Agent Object to provide the necessary value. For more information, see Creating Your Extensibility Code.

  • Mapping custom test object classes to inner objects. You map the test object classes that you defined in the test object configuration file (if any) to existing UFT One Standard Windows test object classes that serve as inner objects. UFT One uses the inner object's implementation for any properties or methods for which specific support is not provided by the Agent Object that you develop.

    Mapping your new Delphi test object classes to inner objects enables you to take advantage of existing UFT One GUI testing support for common methods and properties. This can be helpful, for example, when creating support for subclassed Standard Windows controls such as TListView. For a list of existing Standard Windows test object classes, see the UFT One Object Model Reference for GUI Testing.

In some dialog boxes, UFT One displays a list of available test object classes per environment (for example, in the Define New Test Object dialog box, the Object Identification dialog box, and the Step Generator). If you want UFT One to display your custom Delphi test object classes in these dialog boxes, you must define this in the toolkit configuration file as well.

For information on the structure and syntax of this XML, see Understanding the Toolkit Configuration XML File Structure.