SAP Get Text 

An SAP Get Text building block is used to find text in SAP GUI.

Fully expanded, the SAP Get Text block shows the following properties:

SAP get text

 

The Block Header ("SAP Get 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 text has been successfully found.

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

Select SAP Element

This property contains the locator for the SAP element to be found.

An SAP element can be captured by right-clicking on the property and selecting “Capture new 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. This is typically used to branch execution flows or to explicitly fail a case by linking it to a Fail block.

Target

This property contains the SAP target value. This value get set as soon as element is been captured.

Text Fields

These fields enable the use of external values (dynamic data) in the “Target”.

Target fieldsTo use the value of an added field, right-click the text field above where the validated text can be entered,  select “Insert token”, then insert this field’s name.

Fields can be renamed by double-clicking on them. The tokens will change their visual appearance accordingly.

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 numbers that “Starts with” or “Ends with“ or “Contains” the word 'Unit'.

Filter Value

The value used by the filter.

Filter value

Use Occurrence

Select which occurrence of the text to use, if more than one is found.

Select “All” to iterate through all of the occurrences. By selecting “All”,

Count

It gives the total count of occurrences of the found text.

Session

This property is used to support multi-session functionality of SAP.

Default Timeout

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