Skip to content

Match Text Activity

The Match Text activity locates specified text on the current screen, irrespective of the browser or application. It identifies the coordinates of the found text, enabling subsequent actions based on its position.

Field Description Requirement
Text The text to be searched on the screen. Required
X-coordinate Limits the text search area. This field must be configured along with Y-coordinate, Height, and Width. Optional
Y-coordinate Limits the text search area. This field must be configured along with X-coordinate, Height, and Width. Optional
Width Limits the text search area. This field must be configured along with X-coordinate, Y-coordinate, and Height. Optional
Height Limits the text search area. This field must be configured along with X-coordinate, Y-coordinate, and Width. Optional
Language The language of the text to be scanned. Required
Retry count The number of attempts to find the text. Optional
Return x-position A variable name to assign the found X-coordinate. Required
Return y-position A variable name to assign the found Y-coordinate. Required

Action Types & Examples

Return X-Position

  • Format: Digit
  • Example Result: 300

Return Y-Position

  • Format: Digit
  • Example Result: 280

Implementation Examples

Field Setup - Text:Deneme- `Text: `${deneme} - X-coordinate:700- `Y-coordinate: `400 - Width:120- `Height: `35 - Language:TUR- `Language: `ENG - Retry count:5``

Execution Parameters - Return x-position:xPositionValue- `Return y-position: `yPositionValue - Mouse Activity X Position:${xPositionValue}- `Mouse Activity Y Position: `${yPositionValue} - Mouse Activity Action:LEFT_CLICK``

Technical Notes

The values for Height and Width must be integers. The Return x-position and Return y-position variables capture the coordinates of the found text. These variables can then be used in subsequent activities, such as the Mouse activity, to perform actions at the identified location. For instance, assigning xPositionValue and yPositionValue to the Mouse activity's X Position and Y Position fields, respectively, enables a click action at the text's location.