Tips and tricks Best practice guides, FAQ & more
An SAP Get Text building block is used to find text in an 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 gets set as soon as element has 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” the text inside paragraphs is “Status: Green Mode today” then only “Green Mode” 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' checkbox is unchecked, then you can enter the timeout value based on requirement otherwise the timeout value is set as 10 seconds. If the 'Default Timeout' checkbox is checked, the 'Default timeout' value selected in the flow settings will be applied.