Knowledge base
Tips and tricks Best practice guides, FAQ & more
Find tutorials, guides and use case examples in the
Learning center
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”.
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.
This property contains the SAP target value. This value gets set as soon as element has been captured.
Wildcards can be used in the Target field to make automation script more flexible and dynamic in nature. To insert the wildcard, click on insert token and select wildcard.
Ex: [5,"Lo(wildcard)"] It will fetch fifth element starts with Lo.
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.
©2024, Leapwork. All rights reserved.