Get Mobile Text

A Get Mobile Text block is used to fetch text from an application. When you click on Expand, the block lists the below properties.

Get-Mobile-Text

The Block Header (“Get Mobile Text”)

The green input connector in the header is used to trigger the block to start executing.

The green output connector in the header triggers when the mobile text has been successfully found.

The title of the block (“Get Mobile Text”) can be changed by double-clicking on it and typing in a new title.

Select Mobile Element to get text

This property contains the locator for the mobile element from which the text has to be extracted.

A mobile element locator can be captured by right-clicking on the property and selecting “Capture new mobile element”. The mobile element locator can also be captured by clicking on the property which opens the mobile recorder.

The property can be cleared by right-clicking and selecting “Clear mobile element”.

Text found

This property contains the text that was found.

Not found

This green output connector triggers if suitable text is not found before the timeout (see below). This is typically used to branch execution flow or to explicitly fail a case by linking it to a Fail block.

Position found

The position where the text was found in X, Y coordinates.

Click the Expand button to work with the X and Y coordinates separately.

Area found

The position and size of the number found in X, Y, Width, Height coordinates, starting with the upper-leftmost pixel..

Click the Expand button to work with the area’s position and size and their nested sub-properties separately.

Find format

Define a format that the text must meet to be retrieved. For instance, by defining “Status: [TEXT] today” only text inside paragraphs such as “Status: Green Mode today” will be retrieved.

Is case sensitive

Select whether the format should be case sensitive. By default, it is case insensitive.

Filter

Define a filter that the text must meet to be retrieved. For instance, only retrieve text that “Starts with” the word Green.

Default timeout

If the 'Default Timeout' property checkbox is not selected, then the timeout value is 60 seconds. If the 'Default Timeout' property checkbox is selected, then the 'Default timeout' value selected in the flow settings will be applicable.

Timeout

The maximum time spent searching for the text before giving up and triggering “Not found” (see above).

Note: All cases have a “global timeout” that can be configured in the “Settings” panel. This is unrelated to the timeout of a single building block. However, a running case will automatically be cancelled if it runs for longer than the global timeout.