Read SAP Table

This block lets you fetch a specified range of values using a table construct that Leapwork has captured from an 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, and so on).

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

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.


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 gets set as soon as element has 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' 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 in the flow settings will be applied.