Sap Get Form Fields
sap_get_form_fieldsDiscover fillable fields on the active SAP screen or popup, including field IDs, labels, types, and current values. Enable dropdown option fetching to map choices for form automation.
Instructions
Discover fillable form fields on the current SAP screen (or active popup dialog). Returns field IDs, labels, types (text/dropdown/checkbox/radio), and current values. Automatically targets the active window — if a popup is open, shows popup fields. Use include_dropdown_options=True to also fetch available options for dropdown fields.
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_get_form_fields"
}
}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. | |
| include_dropdown_options | No | If True, opens each dropdown to capture available options. This is slower but provides complete information for dropdowns. Default is False (lazy fetching). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Error message if success=False | |
| popup | No | Present when a popup dialog is active on screen | |
| fields | No | Fillable fields discovered on the current screen | |
| success | No | Whether the operation succeeded | |
| active_window | No | Which window was operated on (e.g., 'wnd[0]', 'wnd[1]'). If 'wnd[1]' or higher, a modal dialog is open. |