Understanding the Object Learn Chain of Events
When learning an object, OpenText Functional Testing first builds the test object hierarchy. Then, if the user clicked a location that is associated with more than one object, the Object Selection dialog box opens. After the user selects the required object, the GetChildren method is called with an empty filter argument (that is, it contains only the XML root element <Filter/>). This requires the Testing Agent to return all of the immediate children of the specified object.
If the specified object has children, the Define Object Filter dialog box opens in OpenText Functional Testing to enable the user to select the types of descendants to learn.
Next, the LearnChildObjects method is called to retrieve the object IDs and descriptions for the specified object and all of its ancestors and descendants.
The following diagram shows the general sequence of methods that OpenText Functional Testing calls when learning a object. This diagram illustrates the purpose of the methods that the Testing Agent must implement and the interfaces to which these methods belong. For example, GetElementFromPoint, a member of the ISpyable interface, is called. After the object ID of the specified object is retrieved, GetElementType and GetParent are called for each object in the hierarchy. GetElementType and GetParent are members of the ITestable interface.


