Sap Fill Form
sap_fill_formFill multiple SAP form fields in one call on the same screen, skipping missing fields unless strict mode is enabled. Use for batch data entry without navigation between fields.
Instructions
Fill multiple SAP form fields in a single call. Use this when filling 2+ fields on the SAME screen without UI navigation between them.
Keys can be:
Visible label text (e.g., 'First Name', 'Straße') — works on both backends
CSS selectors starting with '#' (WebGUI, e.g., '#M0:46:1:1::0:21')
SAP GUI element names (Desktop, e.g., 'BUT000-NAME_LAST')
When to use:
Filling a form with multiple input fields
All fields visible on current screen
No button clicks or navigation needed between fields
When NOT to use:
Single field only (use sap_set_field)
Fields on different screens/tabs
Need to click buttons between fills
Session parameter:
session=None (default): Uses primary session ("s1")
session="s2": Targets specific session (for parallel agents)
Example payload:
{"fields": {"Vorname": "Mario", "Nachname": "Rossi"}, "strict": false}
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"fields": "<fields>"
},
"name": "sap_fill_form"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | Yes | Dictionary mapping field identifiers to values. Keys can be visible label text (e.g., 'First Name'), CSS selectors on WebGUI (e.g., '#M0:46:1:1::0:21'), or SAP GUI element names on Desktop (e.g., 'BUT000-NAME_LAST'). | |
| strict | No | If True, fail if any field is not found. If False, skip missing fields and report them. | |
| 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 |
|---|---|---|---|
| error | No | Error message if success=False | |
| popup | No | Present when a popup dialog is active on screen | |
| errors | No | Fields that errored during fill | |
| filled | No | Fields successfully filled | |
| success | No | Whether the operation succeeded | |
| not_found | No | Fields not found on page | |
| active_window | No | Which window was operated on (e.g., 'wnd[0]', 'wnd[1]'). If 'wnd[1]' or higher, a modal dialog is open. |