Sap Read Status Bar
sap_read_status_barRead the current message from SAP's status bar and return a language-independent message ID plus parameters, so agents can detect errors or confirmations after an action.
Instructions
Read the current message from SAP's status bar
Also returns message_id / message_number (desktop only), which identify the message independently of the logon language, plus message_parameters (its &1-&4 runtime values, which may themselves be translated).
Session parameter:
session=None (default): Uses primary session ("s1")
session="s2": Targets specific session (for parallel agents)
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "sap_read_status_bar"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session | No | Session ID (e.g., "s1", "s2"). None uses primary session. | |
| agent_id | No | Agent identifier for binding check. Optional. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Message type: 'S' (success), 'E' (error), 'W' (warning), 'I' (info), or 'none' | |
| error | No | Error message if success=False | |
| popup | No | Present when a popup dialog is active on screen | |
| message | No | Status bar text | |
| success | No | Whether the operation succeeded | |
| message_id | No | T100 message class (e.g. 'DS'), padding stripped; None when the bar is empty or the SAP GUI does not expose it. Together with message_number it identifies a message independently of the logon language, so check these instead of the text. Desktop backend only; the WebGUI backend leaves it None. | |
| active_window | No | Which window was operated on (e.g., 'wnd[0]', 'wnd[1]'). If 'wnd[1]' or higher, a modal dialog is open. | |
| message_number | No | T100 message number, zero-padded (e.g. '017'); None when the bar is empty or the SAP GUI does not expose it. Language-independent. Desktop backend only; the WebGUI backend leaves it None. | |
| message_parameters | No | Message variables &1-&4 (index 0 is &1), trailing empty values removed; [] when the bar is empty. These are runtime values and may themselves be translated text, so they are not a language-independent identity. Desktop backend only; the WebGUI backend leaves it empty. |