About Test Object Map

The Functional Tester test object map lists the test objects in the application-under-test. It is a static view that describes test objects known to Functional Tester in the application-under-test.

A test object map can include objects from multiple applications. The test object map provides a quick way to add test objects to a script. Because the test object map contains recognition properties for each object, you can update the information in one location. Any scripts that reference that test object map share the updated information.

When you record a script, Functional Tester creates a test object map (or uses an existing shared map) for the application-under-test. Each script is associated with a test object map file. The map file can be private, associated with only the script (*.rftxmap), or shared between scripts (*.rftmap).

You can merge multiple private or shared test object maps into a single shared test object map.

For Functional Tester, Java Scripting, you can create a new test object map or for Functional Tester, VB.NET Scripting, you can create a new test object map to customize the information associated with a script. You can edit an existing test object map to add objects to the map, delete objects, update the recognition properties or unify two objects in the map. Additionally, you can delete a test object map.

You can display a list of scripts associated with a test object map. You can use this list to add test objects to multiple scripts.

For more information on creating and using a test object map, see creating and using a test object map to test applications. For an overview on test object map maintenance, see maintaining your test object map.

To open a test object map in Functional Tester, Java Scripting:

To open a test object map in Functional Tester, VB.NET Scripting:

When you open a test object map that has no test objects, Functional Tester opens a Help topic that explains how to add objects to a test object map.

The test object map window has four main components:

Test Object Map Menu

Test Object Map Toolbar

Test Object Hierarchy

Property Sets

 Test Object Map Menu

The Test Object Map menu has the following options:

File Menu Options:

Save -- Saves your changes to the test object map.

Revert -- Restores the map to the version last saved.

Checkout -- If the test object map is checked in, checks the map out of ClearCase. If the test object map is private, Functional Tester checks out the script too. If the test object map is shared, Functional Tester just checks out the map and not the script.

Renew All Names in Associated Script(s) -- Renews all the names of script test objects in associated script(s).

Exit -- Closes the test object map.

 

Edit Menu Options:

Cut -- Removes properties selected on a property set tab to a local Clipboard.

Copy -- Copies properties selected on a property set tab to a local Clipboard.

Paste -- Inserts properties previously saved to a local Clipboard at the cursor location property set.

Delete -- Depending on which pane has focus, deletes the selected test object from the test object map or deletes properties from the property set.

 

Find Menu Options:

Quick Find -- Opens the Quick Find dialog box, which enables you to search for a test object based on a string you specify.

Find by Filters -- Opens the Set Active Find Criteria dialog box, which enables you to select the filter to use for searching the test object map or to create a new filter.

Find & Modify -- Opens the Find & Modify dialog box, which enables you to do either a Quick Find or a Find by filters and make modifications to the results.

Find Used -- Finds all the test objects that have references in the scripts associated with a shared test object map.

Find Not Used -- Finds test objects that have no references in scripts associated with the test object map.

Delete All Not Used -- Opens the Delete All Not Used Test Objects dialog box, which enables you to selectively delete test objects that do not have references in the script associated with the test object map.

First -- Moves to the first test object in the hierarchy that matches the search criterion. The default criterion is State Not Clean, which searches the test object map for all objects that have a New state. For information, see Searching for Objects in a Test Object Map.

Previous -- Moves to the previous test object in the hierarchy that matches the search criterion. The default criterion is State Not Clean, which searches the test object map for all objects that have a New state. For information, see Searching for Objects in a Test Object Map.

Next -- Moves to the next test object in the hierarchy that matches the search criterion. The default criterion is State Not Clean, which searches the test object map for all objects that have a New state. For information, see Searching for Objects in a Test Object Map.

Last -- Moves to the last test object in the hierarchy that matches the search criterion. The default criterion is State Not Clean, which searches the test object map for all objects that have a New state. For information, see Searching for Objects in a Test Object Map.

 

Test Object Menu Options:

Insert Object(s) -- Opens the Insert a GUI Object into the Object Map dialog box, which enables you to select test objects to add to the test object map and make them available for scripts.

Update Recognition Properties -- Enables you to update the recognition properties of a test object frame in the application-under-test.

Description Property -- Opens the Set Description Property dialog box, which enables you to enter descriptive text about the object. Functional Tester adds the description to the Administrative property set tab for the object and displays the description when you place the cursor over the object name in a script.

Add to Script script -- Adds the selected object to the Script Explorer, which enables you to add it to the script and select a method. Functional Tester changes this menu item to Add to Multiple Scripts to indicate that multiple scripts have been selected and are affected by the command.

Associated Scripts -- Displays a list of scripts that are associated with the test object map.

Accept Node -- Changes the state of the selected test object from New to "Clean."

Accept All -- Changes the state of all test objects from New to "Clean."

Highlight -- Locates the test object in the application-under-test, if visible. If Functional Tester finds more than one instance of the test object, you can display neither or the top two candidates.

Renew Name in Associated Script(s) -- Renews the name of an individual script test object in associated script(s).

 

Preferences Menu Options:

Toolbars -- Enables you to display or hide the File, Edit, Find, TestObject, Applications, Display, and Help toolbars.

Test Object Description -- Opens the Edit Test Object Description dialog box, which enables you to customize the text displayed for each object in the Test Object Hierarchy.

Clear State on Close -- Accepts all test objects in the test object map by changing their state from New to "Clean" when you close the map.

Highlight -- Opens the Set Highlight Window Preferences dialog box, which enables you to specify how to emphasize objects in the application-under-test when you select them.

 

Applications Menu Options:

Run -- Opens the Start Application dialog box, which enables you to start a specific application and add test objects to the test object map.

The Applications menu also lists up to nine of the most recently used applications. A number appears next to each application on the menu, which enables you to select an application by typing the number that corresponds to the application. You can also click the application name at the bottom of the Applications menu.

 

Display Menu Options:

Expand All -- Displays all test objects in the hierarchy.

Collapse to Selected -- Closes all test objects in the hierarchy except in the selected tree.

Toggle Orientation -- Switches between displaying the property sets under or next to the Test Object Hierarchy.

 

Help Menu Options:

Test Object Map Help -- Displays Help for the test object map.

Insert Test Object Help -- Displays Help for adding objects to a test object map.

New Test Object Help -- Displays Help that describes how to set the option to display the test object map for a new object.

 

Test Object Map Toolbar

The Test Object Map toolbar has the following buttons:

File: Save File: Save -- Saves changes you make to the test object map.

File: Revert File: Revert -- Restores the map to the version last saved.

File: Checkout File: Checkout -- If the test object map is checked in, checks the map out of ClearCase. If the test object map is private, Functional Tester checks out the script too. If the test object map is shared, Functional Tester just checks out the map and not the script.

File: Cut Edit: Cut -- Removes text selected in the property set tab to a local Clipboard.

File: Copy Edit: Copy -- Copies text selected in the property set tab to a local Clipboard.

File: Paste Edit: Paste -- Inserts text previously saved to a local Clipboard at the cursor location in the property set.

Edit: Delete Edit: Delete -- Deletes the selected test object from the test object map.

Find: Quick Find: Quick -- Opens the Quick Find dialog box, which enables you to search for a test object based on a string you specify.

Find: Filters Find: Filters -- Opens the Set Active Find Criteria dialog box, which enables you to select the filter you want to use for searching the test object map or to create a new filter.

Find: Find & Modify Find: Find & Modify -- Opens the Find & Modify dialog box, which enables you to use Quick Find or Find by filters and make modifications to the results.

Find: Used Find: Used -- Finds all the test objects that have references in the scripts associated with a shared test object map.

Find: Not Used Find: Not Used -- Finds test objects that do not have references in scripts associated with the test object map.

Delete All Not Used Delete All Not Used -- Opens the Delete All Not Used Test Objects dialog box, which enables you to selectively delete test objects that do not have references in the script associated with the test object map.

Find: First Find: First -- Moves to the first test object in the hierarchy that matches the search criterion. The default criterion is State Not Clean, which searches the test object map for all objects that have a New state. For information, see Searching for Objects in a Test Object Map.

Find: Previous Find: Previous -- Moves to the previous test object in the hierarchy that matches the search criterion. The default criterion is State Not Clean, which searches the test object map for all objects that have a New state. For information, see Searching for Objects in a Test Object Map.

Find: Next Find: Next -- Moves to the next test object in the hierarchy that matches the search criterion. The default criterion is State Not Clean, which searches the test object map for all objects that have a New state. For information, see Searching for Objects in a Test Object Map.

Find: Last Find: Last -- Moves to the last test object in the hierarchy that matches the search criterion. The default criterion is State Not Clean, which searches the test object map for all objects that have a New state. For information, see Searching for Objects in a Test Object Map.

Test Object: Insert Object(s) Test Object: Insert Object(s) -- Opens the Insert a GUI Object into the Object Map dialog box, which enables you to select test objects to add to the test object map and make them available for scripts.

Test Object: Update Recognition Properties Test Object: Update Recognition Properties -- Enables you to update the recognition properties of a test object in the application-under-test.

Test Object: Description Test Object: Description -- Opens the Set Description Property dialog box, which enables you to enter descriptive text about the object. Functional Tester adds the description to the Administrative Property Set tab for the object and displays the description when you place the cursor over the object name in a script.

Test Object: Add to Script: script Test Object: Add to Script: script -- Adds the selected object to the Script Explorer, which enables you to add it to the script and select a method. Functional Tester changes the text in the tooltip for this button to Add to Multiple Scripts to indicate that multiple scripts have been selected and will be affected by the command.

Test Object: Associated Scripts Test Object: Associated Scripts -- Opens the Associated Scripts dialog box, which lists scripts associated with a test object map.

Test Object: Accept Node Test Object: Accept Node -- Changes the state of the selected test object from New to "Clean."

Test Object: Accept All Test Object: Accept All -- Changes the state of all test objects from New to "Clean."

Test Object: Highlight Test Object: Highlight -- Locates the test object in the application-under-test, if visible. If Functional Tester finds more than one instance of the test object, you can display neither or the top two candidates.

Test Object: Renew Name in Associated Script(s) Test Object: Renew Name in Associated Script(s) -- Renews the name of an individual script test object in associated script(s).

Application: Run Application: Run -- Opens the Start Application dialog box, which enables you to start an application and add test objects to the test object map.

Expand All Expand All -- Displays all the test objects in the hierarchy.

Collapse to Selected Collapse to Selected -- Closes all the test objects in the hierarchy except in the selected tree.

Display: Toggle Splitter Orientation Display: Toggle Splitter Orientation -- Changes the property sets display from under the Test Object Hierarchy to beside it.

Help: Help Help: Help -- Displays online Help for the test object map.

 

Test Object Hierarchy

The Test Object Hierarchy lists all test objects in the application-under-test and provides the following information for each:

In Functional Tester, Java Scripting, you can change the color of the Owned test object in the test object map. In Functional Tester, VB.NET Scripting, you can change the color of the Owned test object in the test object map.

Each test object in the list is preceded by an icon that indicates its role. For more information, see a table with the test object map icons and their roles.

You can also customize the information that is displayed in the Test Object Hierarchy.

You can use the test object map to locate an object in the application-under-test.

 

Property Sets

The lower (or right) pane of the Test Object Map window contains property sets, which provide information about the selected object. There are two property set tabs:

The Recognition tab contains the recognition data used by Functional Tester. The Administrative tab contains the internal administrative data of the object. These properties are used to manage and describe the test object. Updating the properties on this tab affects the future code generation of scripts that use this test object. For example, updating the Descriptive Name causes the new name to be used the next time this test object is added to a script, depending on the template used.

Recognition and administrative data are the properties from the object map that are used to locate and manage this test object in the context of the associated script. For information, see Using ScriptAssure (TM).

To edit a value in either of the tabs, double-click the value.

If you select a recognition property value and right-click, you can use any of these various options:

Open -- Displays the value in a separate window, which enables you to see long lines of text.

Case Sensitive Regular Expression Case Sensitive Regular Expression -- Sets case-sensitive comparison in regular expressions on and off.

Evaluate Regular Expression Evaluate Regular Expression -- Starts the Regular Expression Evaluator, which enables you to test the regular expression before you try it in a test object find.

Convert Value to Regular Expression Convert Value to Regular Expression -- Converts the recognition property value in the Updated Test Object Properties grid to a regular expression. For more information, see Replacing an Exact-Match Property with a Pattern.

Undo Regular Expression Undo Regular Expression -- Restores the original value of the regular expression.

Convert Value to Numeric Range Convert Value to Numeric Range -- Converts the recognition property value in the Updated Test Object Properties grid to a numeric range. For more information, see Replacing an Exact-Match Property with a Pattern.

Undo Numeric Range Undo Numeric Range -- Converts the numeric range back to the original value.

You can change a property value to a regular expression or numeric range by using the test object map editor. For information, see Replacing an Exact-Match Property with a Pattern.

When a test object changes, you can update its recognition properties in the application-under-test.

You can add a descriptive name as a property on the Administrative tab for an object.

You can also specify color settings for several elements in a test object map.

Terms of use | Feedback
(C) Copyright IBM Corporation 2002, 2004. All Rights Reserved.