Rules For Object Recognition
SilkTest
2006 Release 2
Borland Software Corporation 20450 Stevens Creek Blvd., Suite 800
Cupertino, California 95014 USA http://www.borland.com
Borland Software Corporation may have patents and/or pending patent applications covering subject matter in this document.
Please refer to the product CD or the About dialog box for the list of applicable patents. The furnishing of this document does not
give you any license to these patents.
Copyright © 1992–2007 Borland Software Corporation and/or its subsidiaries. All Borland brand and product names are trademarks
or registered trademarks of Borland Software Corporation in the United States and other countries. All other marks are the property
of their respective owners.
January 2007
PDF
Table of Contents
Construction of Window Declaration Identifiers and Tags ........................................................4
Legend and Notes .............................................................................................................4
DOM Extension .................................................................................................................5
Html Object Recognition ....................................................................................................8
Construction of Window Declaration Identifiers and Tags
SilkTest’s object recognition system uses a Window Declaration Identifier as the logical name of
an object and a Tag or Multitag as the attribution for uniquely identifying an object. To permit
robust operation across browsers, SilkTest uses a complicated system of rules to construct the
identifiers and associated attributes.
The Window Declaration Identifiers and Tags or Multitags are constructed hierarchically from
information such as HTML object attributes and closest static text. The class dependent Caption
and WindowID construction rules form the basis for the Window Declaration Identifier, Single
Tag, and Multitag construction rules. The Index construction rules are class independent.
Legend and Notes
Recognition effectiveness is not usually affected by the character length restrictions placed on
the Caption, WindowID, and Window Declaration Identifier.
CST :Closest Static Text
BNT :Browser Nearest Text Checkbox
(Agent CST default, Browser CST option)
Caption :Restricted to 127 characters
WindowID :Restricted to 63 characters
HTML Tag Attributes :ALT, CONTENT, HREF, HTTP-EQUIV, ID, NAME, SRC, VALUE
Window Declaration
Identifier :Restricted to 27 characters
"->" :Interpret as "takes precedence over"
4Test :Produces - Window Declaration Identifier, Single Tag or Multitag
Agent :Produces - Index, Prior Text, Location
Extension :Produces - WindowID, Caption
Rules For Object Recognition 4
DOM Extension
The following tables define the fundamental relationships and rules used during DOM
processing.
Fundamental Relationships in DOM
Class Caption Rules WindowID Rules
Browser Child TITLE -> Page Location (URL) Page Location (URL)
Browser Child TITLE (Frame) -> NAME (Frame)
None
Frame -> Page Location (URL)
HtmlCheckBox Browser CST NAME -> Class Name Counter
HtmlColumn Inner Text -> BNT ID
HtmlComboBox not Applicable in DOM
HtmlForm NAME -> BNT ID
HtmlHeading Text ID
HtmlHidden Inner Text -> BNT NAME
HtmlImage
ALT -> BNT NAME -> HREF
<IMG SRC>
HtmlImage not applicable in DOM - mapped to HtmlPushButton
<INPUT type=image SRC>
HtmlLink-text
Inner Text -> Agent CST NAME -> HREF
<A>HREF text </A>
HtmlList Browser CST NAME
HtmlListBox Browser CST NAME -> Blank
HtmlMarquee BNT ID
HtmlMeta NAME -> HTTP-EQUIV -> BNT CONTENT
HtmlPopupList BNT NAME
HtmlPushButton
ALT -> Agent CST NAME
<INPUT type=image SRC>
HtmlPushButton
<INPUT type= VALUE -> Agent CST (when '<' is
NAME
[reset,submit] SRC> first character of VALUE)
<BUTTON>
HtmlRadioButton BNT NAME -> Class Name Counter
HtmlRadioList BNT NAME -> Class Name Counter
HtmlTable Caption -> BNT ID
HtmlText Text ID
HtmlTextField Browser CST NAME
HtmlTextField
Browser CST NAME -> FILE_INPUT
<INPUT type=file SRC>
XMLNode VALUE -> NAME Internally Generated Integer
Rules For Object Recognition 5
Window Declaration Identifier Rules in DOM
Class Rule
for Use WindowID option: WindowID -> Caption -> Index
All
for Use Caption option: Caption -> WindowID -> Index
Same CST used for multiple ojects of same class: postpend
All WindowID with Index, postpend Caption with Index in
brackets
Same CST used for multiple ojects of different classes:
All
postpend WindowID with Index
All Only Index exists: postpend class with Index
Class Rule
All Relative to parent: left-to-right then top-to-bottom
Single Tag Rules in DOM
Class Rule
All User Interface controls Tag selection
Rules For Object Recognition 6
Multitag Rules in DOM
Class Rule
Browser Child Caption - not selectable through UI
Browser Child
Caption - not selectable through UI
Frame
HtmlCheckBox Caption, Index, and WindowID - not selectable through UI
HtmlColumn Selectable through UI
HtmlComboBox not applicable in DOM
HtmlForm Caption, Index, and WindowID - not selectable through UI
HtmlHeading Selectable through UI
HtmlHidden Caption, Index, and WindowID - not selectable through UI
HtmlImage
Caption, Index, and WindowID - not selectable through UI
<IMG SRC>
HtmlImage
not applicable in DOM - mapped to HtmlPushButton
<INPUT type=image SRC>
HtmlLink-text
Caption, Index, and WindowID - not selectable through UI
<A>HREF text </A>
HtmlList Selectable through UI
HtmlListBox Caption, Index, and WindowID - not selectable through UI
HtmlMarquee Caption, Index, and WindowID - not selectable through UI
HtmlMeta Caption, Index, and WindowID - not selectable through UI
HtmlPopupList Caption, Index, and WindowID - not selectable through UI
HtmlPushButton
Caption, Index, and WindowID - not selectable through UI
<INPUT type=image SRC>
HtmlPushButton
<INPUT type=
Caption, Index, and WindowID - not selectable through UI
[reset,submit] SRC>
<BUTTON>
HtmlRadioList Caption, Index, and WindowID - not selectable through UI
HtmlTable Selectable through UI
HtmlText Selectable through UI
HtmlTextField Caption, Index, and WindowID - not selectable through UI
HtmlTextField
Caption, Index, and WindowID - not selectable through UI
<INPUT type=file SRC>
XMLNode Selectable through UI
Rules For Object Recognition 7
Html Object Recognition
This table shows how SilkTest maps 4Test objects to HTML objects.
Html Object Recognition
4Test class HTML tag
HtmlCheckBox <input type=checkbox>
HtmlColumn <th>, <td> is column if the <td> is in the first row and there is no <th>
HtmlForm <form>
HtmlHeading <h1>, <h2>, <h3>, <h4>, <h5>, <h6>, <th>
HtmlHidden <input type=hidden>
HtmlImage <img>
HtmlLink-text <a href=…> <area>
HtmlList <ol, <ul, <dl, <dir, <menu
HtmlListBox <select size=1>
HtmlMeta <meta>
HtmlPopupList <select size= > if size is larger than 1
HtmlPushButton <button>, <input type=button>, <input type=file>, <input type=image>,
<input type=reset>, <input type=submit>
HtmlRadioList <input type=radio>
HtmlTable <table>
HtmlText <a> without <href>, <abbr>, <acronym>, <b>, <bdo>, <big>, <blockquote,
<br>, <center>, <cite>, <code>, <dd>, <dfn>, <div>, <dt>, <em>, <font
<kbd>, <I>, <label>, <left>, <legend>, <li>, <nobr>, <p>, <pre>, <q>,
<right>, <s>, <samp>, <sapn>, <small>, <strike>, <strong>, <sub>, <sup>,
<tt>, <u>, <var>, <xmp>
HtmlTextField <input type=file>, <input type=password>, <input type=text>, <textarea>
XMLNode
Rules For Object Recognition 8
