Specifics of Flex-Based AIR Applications' Object Hierarchy

General Notes

Object Hierarchy

Container Objects in the Object Tree

Like any other application, a Flex-based AIR application is represented as a hierarchy of objects. The way TestComplete represents a Flex-based AIR application in the Object Browser depends on the value of the native showInAutomationHierarchy property of internal objects of the application. You can change the value of this property to move objects within the object’s hierarchy to make the hierarchy more suitable for your testing needs (see below.)

The easiest way to understand how TestComplete represents the internal structure of your Flex-based AIR application is to explore the application in the Object Browser or Object Spy.

Click the image to enlarge it.

As you can see, the internal structure of a Flex-based AIR application corresponds to the .mxml file that declares the interface of your application.

Flex-based AIR applications often include container objects (like Canvas, HBox, VBox, etc.) that are not really important for functional testing. To simplify scripting access to child objects of these containers, TestComplete duplicates them in the object hierarchy as follows:

• TestComplete finds a container object and checks whether its showInAutomationHierarchy native property is set to False (the default value of this property).
• Child objects of this container whose showInAutomationHierarchy native property is set to True are duplicated in the object hierarchy. TestComplete places the copies as children of the first ancestor container whose showInAutomationHierarchy property is set to True.
• Child objects of this container whose showInAutomationHierarchy native property is set to False are not duplicated in the object hierarchy.

Click the image to enlarge it.

These child objects are more important for testing than their container. By moving children of a container object to a higher level in the object hierarchy, TestComplete simplifies scripting access to such objects in tests. The paths to these duplicated objects in the object hierarchy become shorter, and this improves the TestComplete performance and test readability. So, while creating your Flex-based AIR application, you can simplify its testing by modifying  the showInAutomationHierarchy property of container objects and their child objects as described above.

To access the showInAutomationHierarchy native property of a Flex container object in your tests, use the FlexObject property (ContainerFlexObj.FlexObject.showInAutomationHierarchy).

For backward compatibility, TestComplete also leaves the initial container and its child objects in the object tree, so you can see these child objects twice in the Object Browser panel (as children of the initial container object with the showInAutomationHierarchy property set to False and as children of an ancestor container with the showInAutomationHierarchy property set to True). However, when recording automated tests, TestComplete operates with duplicated objects that were created on a higher level.