UIA I Creating Modules

The option Use UIAEngine must be selected from the Options dialog in Tosca Wizard before a test object can be scanned. If the test object is specifically registered in WizardMappings.dat, the setting need not be enabled (see chapter "WizardMappings.dat").

Tosca Wizard Option Use UIA Engine

Tosca Wizard scans all items by default, which are visible on the screen. Items, which are only visible after having scrolled down, are thus not scanned by default. If the option Scan all items is selected from the Tosca Wizard main menu (Options->Scanning->Scan all items), all items that are currently visible in the window will be scanned.

The creation of Modules is described in general in the Tosca Commander™ Manual (see chapter "Scan classic Modules with Legacy Scan"). In the chapters below you will be provided with engine specific methods for identifying screens and controls as well as a list of properties and wildcards and their possible uses in the TechnicalID.

Screen identification

Screen contexts are used to identify a technical screen of a test object. This should be unique at the time of execution. Screen contexts can be identified as follows:

Name

Description

TechnicalID

Screens are recognized by any combination of technical properties (see "Technical identification"). In case of names, it is possible to enter a part of a string with wildcards *. If the TechnicalID does not contain any ControlType properties, ControlType.Window is used by default. Please note that only technical, but no business-based properties (such as value) can be used. The properties BoundingRectangle and ClickablePoint are not suitable for identification since they change if the window size or the position of the window is modified.

Example:Name=images;\;ControlType=ControlType.Window

Wildcards

Wildcards can be freely used in the TechnicalID of screens.

Name=*oogle - Win* instead of Name=Google - Windows Internet Explorer

Control identification

The following UIA controls can be identified and steered:

  • Button

  • CheckBox

  • Combobox

  • DataGrid (table)

  • EditBox

  • Group

  • Hyperlink

  • Image

  • ListBox

  • Pane

  • RadioButton

  • Spinner

  • Statusbar

  • TabControl

  • Text

  • Tree

  • Window

Technical identification

A technical description or a logical name is assigned to each element.

The input or selection of the technical ID for an UIA control is done via the table Technical Identifier in Tosca Wizard.

  • If a CheckBox in front of an attribute is selected, the attribute which should be used as the TechnicalID is specified. All controls generally get their technical ID via the attribute Name .

The attribute ObjectIndex excludes the combination with other attributes.

  • To be able to change the value of an attribute, double click in the row of the desired attribute of the Value column. A value can then be written in the field. The value of the Index column is also edited. Only numerical values may be entered here.

These values are specified by the Tosca Wizard and must only be modified in special cases.

  • The plus and minus buttons below the Technical Identifier window allow a customized attribute to be added or deleted.

  • The current definition of the TechnicalID is displayed in the field below the plus and minus buttons. This definition is copied and transferred to the Module.

    Example: <Property>=<Value>;\;ClassName=<Value>;Index=<Value>

Tosca Wizard - Technical Identification

The engine searches for an exact match.

Logical identification

The property Name is generally assigned as the logical name for a control (see "Default logical name").