Flynet Viewer - Screen Definitions Reference

Recognize Tag

Recognize Tag

Previous topic Next topic  

Recognize Tag

Previous topic Next topic  

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.