Improve object identification

This topic describes the features that enable you to improve object identification.

Uniquely identify objects by location

To run a step on an object, the object must be identified uniquely. When multiple objects match your object description, you can information to make it unique.

Add one of the following:

A Position describes the object's ordinal location, and the direction in which to count. For example, Top 3.
A Relation let's you describe your object by its proximity to another object in the application.

Adding a relation may help create more stable tests that can withstand predictable changes to the application's user interface. Select related objects that are expected to maintain the same relative location to your object over time, even if the user interface design changes.

For example, you might want to add a step that removes an item from shopping cart that contains several items. Each item has its own Remove button.

You can describe the button to click as the Remove button that has the '<item name>' related object to its left.

For details on adding positions and relations, see Manually edit steps.

Turn off Identification text

By default, an object's name, or label, is used in its description, as its Identification text.

To describe an object whose text varies in the application, you might want to use the object's type and position or relation, ignoring its text.

To do this, omit the text for identification from the step you type in the script, or turn off the Identification text toggle in the step editing pane.

This button is available when editing steps, when adding steps from inspection, and when describing a related object.

For more details, see Step syntax and Manually edit steps.

Text recognition in multiple languages

Optical Character Recognition (OCR) technology is used to recognize text in different languages in an application.

English is the default OCR language. However, you can add additional OCR languages to recognize text in other languages. For details, see Customize settings.

You can add the following OCR languages:

Afrikaans, Arabic, Basque, Bulgarian, Catalan, Simplified Chinese, Traditional Chinese, Croatian, Czech, Danish, Dutch, Esperanto, Estonian, Finnish, French, German, Greek, Hebrew, Hungarian, Icelandic, Italian, Irish, Japanese, Korean, Latin, Latvian, Lithuanian, Macedonian, Maltese, Norwegian, Polish, Portuguese, Romanian, Russian, Serbian, Slovenian, Slovak, Spanish, Swedish, Turkish, Ukrainian, Welsh.

Automatic scrolling

When a script is being run, if an AI object is not displayed in the visible part of the web page, the script auto-scrolls further in search of the object. After the object is identified, no further scrolling is performed. This prevents failures during a run session.

By default, the script scrolls down twice. You can customize the direction of the scroll and the maximum number of scrolls to perform, or deactivate scrolling if necessary. For details, see Customize settings.