Object map property placeholders

Usage: Use the following placeholders to customize the following script templates:

• Script: Comment for Test Object
• Script: Comment for top level Test Object
• Script HTML Test Object Name
• Script Java™ Test Object Name
• Script: .Net Test Object Name
• Script: Windows® Test Object Name

map placeholder

Description: Resolves values relative to an entry in the object map. The map placeholder is only valid during helper script method generation and during recording to insert comments into the script, otherwise the test object instance is not known.

Syntax: %map: property%

Functional properties for the map placeholder:

context -- Returns the descriptive name of the closest parent registered in the Object Library as having context.

contextComment -- Returns the resolved context comment registered in the Object Library for the closest parent with context.

topContext -- Returns the descriptive name of the topmost parent unless this object does not have a parent.

topContextComment -- Returns the resolved context comment registered in the Object Library for the topmost parent.

Examples:

%map:context% -- Returns the descriptive name of the closest parent registered in the Object Library as having context.

The recognition property for the map placeholder returns the property name.

Syntax: %map: RecognitionProperty%

• The recognition properties are unique to each type of test object. To get the name of a recognition property for a particular test object to use with the object map placeholder, see the properties on the Recognition tab of the object map.
• Administrative properties are prefixed with a # character to signify that the property is an administrative rather than a recognition property. For information about administrative versus recognition properties, see Property Sets in the Test Object Map topic.

Administrative properties for the map placeholder:

.class -- Returns the Java™ class name, the HTML tag (with an HTML prefix), or the VB class name of the test object.

#name -- Returns the test objects descriptive name.

#role -- Returns the test object role.

#domain -- Returns the domain in which the test object is defined, that is, Java™, HTML, or .NET.

#testobject -- Returns the interface class name used to interact with the test object.

#proxy -- Returns the proxy class name.

#description -- Returns a user-specified description, defined in the object map editor.

Examples:

%map:.class% -- Returns the Java™ class name, the HTML tag (with an HTML prefix), or the VB class name of the test object.

%map:#domain% -- Returns the domain in which the test object is defined, that is, Java™, HTML, or VB.