Recognize Tag
Parents: ScreenGroup, Screen
Children: none
Description
The Recognize tag is the principal means of defining recognition criteria for the ScreenGroup and Screen tags. Recognition is hierarchical, and if ScreenGroup tags are used to nest Recognize tags and Screen tags, each level of ScreenGroup must satisfy the criteria defined in its Recognize tags before any children ScreenGroup or Screen tags are evaluated.
Since the Recognize tag has no children, it should be defined with the closing slash at the end of the tag.
Note: recognition issues during testing can be rapidly diagnosed using the FlyConnector debug property
See the Schema Layout section for examples.
Attributes
Name |
Type |
Description |
row |
required |
Row, starting with 1, where the recognition text appears on the subject screen |
column |
required |
Column, starting with 1, where the recognition text appears |
text |
required |
Text to recognize, at row, column, or clear if this is the special case of the clearscreen (see type description, following) |
type |
optional |
default="include"
values="include", "omit" or "special"
Use include when the presence of the text is required for recognition.
Use omit when the absence of the text is required for recognition.
Use special with text="clear" to identify this screen as the clear screen, which is a screen with no text written anywhere on it. |
spaceType |
optional |
default="blank"
values="blank" or "null"
Note--when the new Version 2 specialAsBlanks attribute in the FlyConnector tag is set to "yes" the spaceType attribute has no effect.
Some screens have null characters (0x00) in-between text characters instead of the blank (0x20 ASCII, 0x40 EBCDIC). If your recognition tag isn't working, the FlyConnector debug attribute set to "yes" can help identify the correct setting for this attribute. |