Read SAP Table

This block lets you fetch a specified range of values using a table construct that Leapwork has captured from SAP GUI. It reads columns and names to get an occurrence, and reads the fields underneath it.

The Read SAP Table block has one limitation: it cannot read values for fields with buttons (such as a checkbox, dropdown, etc.).

Fully expanded, the Read SAP Table block shows the following properties:

Read SAP Table


The Block Header ("Read SAP Table")

The green input connector (top left) triggers this block to begin execution.

The green output connector (top right) is triggered when the table values have been fetched.

The title of the block (“Read SAP table”) 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”.
Once you select the table, all the columns will be visible on the block and values can be fetched using the blue connector.

select SAP Element Read SAP table block


This refers to the data selection method, whether:

  • First row - always select the first row in the range
    Row index - select a specific row, such as the 5th row
    Iterate - continue reading all rows in the range.


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”.

Text fields read SAP

To use the value of an added field, right-click the text field above where the Validate text can be entered and 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.



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

Not found

This green output connector triggers if the SAP element 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.

Default timeout

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