Skip to content

Text Matching Activity

Overview

The Text Matching activity utilizes optical character recognition (OCR) technology to locate and match specific text within a designated area on the screen. This activity enables automation of tasks that involve interacting with text embedded in images or displayed on the user interface.

Field Description Requirement
Source image Specifies the source image file path for text recognition. Required
Source image Base64 Specifies the source image as a Base64 string for text recognition. Required
Text Defines the exact text string the activity searches for within the target area using the OCR engine. Required
Language Specifies the language for OCR. Options: ENG, TR. Setting the appropriate language improves recognition accuracy. Optional
X-coordinate Defines the X-coordinate of the top-left corner of a rectangular region of interest on the screen. All four coordinate fields must be configured together to limit the search area. Optional
Y-coordinate Defines the Y-coordinate of the top-left corner of a rectangular region of interest on the screen. All four coordinate fields must be configured together to limit the search area. Optional
Width Defines the width of a rectangular region of interest on the screen. All four coordinate fields must be configured together to limit the search area. Optional
Height Defines the height of a rectangular region of interest on the screen. All four coordinate fields must be configured together to limit the search area. Optional
Retry count The number of attempts the activity makes to find the specified text. Accepts any numeric value. Optional
Return x-position Variable to store the X-coordinate of the center point of the matched text if found. Required
Return y-position Variable to store the Y-coordinate of the center point of the matched text if found. Required

Action Types & Examples

Return X-Position

  • Format: digit
  • Example Result: 500

Return Y-Position

  • Format: digit
  • Example Result: 300

Implementation Examples

Field Setup - Source image: C:Robustarobusta.png - Source image Base64: iVBORw0KGgoAAAANSUhEUgAA… - Text: Submit - Language: ENG - X-coordinate: 250 - Y-coordinate: 170 - Width: 100 - Height: 75 - Retry count: 3

Execution Parameters - Return x-position: xPositionVar - Return y-position: yPositionVar

Technical Notes

The values provided for Height and Width parameters must be integers. When configuring the activity, either Source image or Source image Base64 should be used, but not both simultaneously. If a region of interest is defined using X-coordinate, Y-coordinate, Width, and Height, all four parameters must be provided.