In a toolkit configuration XML, you must define a Control element for each test object class that you plan to use to support controls in your toolkit. Each Control element must include a TestObjectClass attribute that specifies the name of the test object class to which it applies.

The Control elements are contained within one Controls element, which represents the toolkit as a whole.

The toolkit configuration file must provide information that enables OpenText Functional Testing to identify which test object class to use for each control in the toolkit. This information can be provided at toolkit level or at control level, as described in the following sections.

The toolkit configuration XML can also contain additional information. A brief summary of the possible content of this XML is provided below and more detail on how to design and use the toolkit configuration XML is provided in the subsequent sections of this guide.

The toolkit specific information can include:

A test object class element can include:

• HTML tags and identification conditions or an identification function (and optionally the name of the file that contains the function) used to identify the custom controls that should be represented by this test object class.
• The name of the default file from which implementation functions are called if no file is specifically defined for a function.
• A function (and optionally the name of the file that contains that function) that returns the element whose test object implements the properties and test object methods inherited from the base class and not implemented for this control.
• The functions (and optionally the name of the file containing those functions) that implement the test object methods of this test object class. OpenText Functional Testing calls these functions to perform test steps on the control. If no functions are defined, implementation functions are assumed to have the same name as the test object methods.
• The function (and optionally the name of the file containing the function) that retrieves the identification properties from the control. If no function is defined, OpenText Functional Testing calls get_property_value.
• Elements that indicate whether to use the default Web Event Configuration for handling events on the control and its children, and can specify functions that OpenText Functional Testing can run to perform customized event listening and handling.
• Elements that indicate when to learn the control and its children, and optionally, a function that specifies which children to learn.
• Elements that indicate whether to display test objects of this class in the Object Spy.
• Elements that indicate whether the test object is a container for other test objects in the object repository.
• A function (and optionally the name of the file containing the function) that retrieves the list of possible values for a test object method argument from the control. If no function is defined, OpenText Functional Testing calls get_list_of_values.
• A function (and optionally the name of the file containing the function) that retrieves the state of the supported toolkit, checking whether it is fully loaded on the current Web page.