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:
In the Functional Tester Projects view, either double-click the test object map name or right-click the name and click Open.
In the Script Explorer, expand Test Objects and either double-click the test object map name or right-click the name and click Open.
From the Functional Tester menu, click Script > Open Test Object Map.
To open a test object map in Functional Tester, VB.NET Scripting:
In the Solution Explorer, either double-click the test object map name or right-click the name and click Open.
In the Script Explorer, expand Test Objects and either double-click the test object map name or right-click the name and click Open.
From the Functional Tester menu, click Script > Open Test Object Map.
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:
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.
The Test Object Map toolbar has the following buttons:
File: Save --
Saves changes you make to the test object map.
File: Revert
-- Restores the map to the version last saved.
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.
Edit: Cut --
Removes text selected in the property set tab to a local Clipboard.
Edit: Copy --
Copies text selected in the property set tab to a local Clipboard.
Edit: Paste --
Inserts text previously saved to a local Clipboard at the cursor location
in the property set.
Edit: Delete
-- Deletes the selected
test object from the test object map.
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
-- 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
-- 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 --
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 do
not have 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.
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
-- 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 --
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 --
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) -- 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 -- Enables you to update
the recognition properties of a test object in the application-under-test.
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
-- 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 -- Opens the Associated
Scripts dialog box, which lists scripts associated with a test object
map.
Test Object: Accept
Node -- Changes the state of the selected test object from New to "Clean."
Test Object: Accept
All -- Changes the state of all test objects from New
to "Clean."
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) -- Renews
the name of an individual script test object in associated script(s).
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 --
Displays all the test objects in the hierarchy.
Collapse to Selected
-- Closes all the test objects in the hierarchy except in the selected
tree.
Display: Toggle Splitter
Orientation -- Changes the property sets display from under the
Test Object Hierarchy to beside it.
Help: Help --
Displays online Help for the test object map.
The Test Object Hierarchy lists all test objects in the application-under-test and provides the following information for each:
Color -- Newly added test objects are marked New and displayed in blue. All the test objects that are not used in the scripts associated with the test object map are displayed in red.
Owned -- An owner/owned relationship is not a container relationship. For example, a frame and a dialog box. A parent/child relationship is a frame and a toolbar.
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.
State
New -- Added to the test object map from the Insert a GUI Object into the Object Map dialog box.
"Clean" -- The object has been accepted and any previous state has been cleared. A "clean" object is not labeled, and the state is removed from the hierarchy.
Test domain
HTML
Java
Net
Win
Role -- The generic type of an object, such as Frame or Button
Name -- The descriptive name administrative property.
.class
Java class name, such as java.awt.Button
Html canonical class name, such as Html.HtmlDocument or Html.A
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.
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:
Recognition
Administrative
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 -- Sets case-sensitive
comparison in regular expressions on and off.
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 -- 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 -- Restores the original value of the regular
expression.
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 -- 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.