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:
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.
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”.
This property contains the text that was 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.
This property contains the SAP target value. This value get set as soon as element is been captured.
These fields enable the use of external values (dynamic data) in the “Target”.
To 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.
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.
Select whether the format should be case sensitive. By default, it is case insensitive.
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'.
The value used by the filter.
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”,
It gives the total count of occurrences of the found text.
This property is used to support multi-session functionality of SAP.
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.