OData und SAP
Das OData-Plugin macht RequestTailor zu einem Client, der weiß, wie SAP-Dienste sich verhalten: Es liest $metadata, holt CSRF-Token, merkt sich ETags, baut $batch-Requests und führt Draft-Aktionen aus.1 Deine Requests bleiben normale Dateien. Der Kern von RequestTailor enthält kein SAP-Wissen; das Plugin nutzt dieselbe öffentliche Plugin-API wie jedes andere.
- Edition
- Free
- Einschalten
- beim ersten Start „SAP and OData“ wählen oder später in den Plugin-Einstellungen
- Protokolle
- OData V2 und V4
- Wo
- Collection-Tabs OData und SAP systems; Request-Tabs Query, Batch, Draft
- Pipeline
rt send … --plugin odata.wasm
Das Plugin einschalten
Das OData-Plugin wird mit der App ausgeliefert, ist aber nur aktiv, wenn du beim ersten Start SAP and OData wählst – oder es später in den Plugin-Einstellungen einschaltest. Wer SAP nicht wählt, sieht nichts von SAP: Ein deaktiviertes Plugin hat keine Tabs und keine Hooks.
Vor der Installation zeigt es seine Rechte, wie jedes Plugin (siehe Plugins):
- network – nur zum Host des Requests, der gerade gesendet wird;
- storage – ein eigener Speicher für zwischengespeicherte Metadaten, CSRF-Token und ETags;
- variables – die nicht geheimen Variablen, für
sapClientundsapLanguage.
| Dienst | Typische Wurzel | Protokoll |
|---|---|---|
| SAP-Gateway-Dienste auf S/4HANA | /sap/opu/odata/sap/<SERVICE>/ | OData V2 |
| RAP-Business-Services | /sap/opu/odata4/sap/<service>/srvd_a2x/…/0001/ | OData V4, mit Draft |
| CAP-Dienste | /odata/v4/<service>/, V2-Adapter /odata/v2/<service>/ | OData V4 mit Draft, und V2 |
Ein eigenes System anbinden
- Eine Collection anlegen oder die
$metadatades Dienstes importieren – vom System oder als API-Spezifikation aus dem SAP Business Accelerator Hub (EDMX oder OpenAPI mitx-sap-Erweiterungen). Der Importer legt je Entity-Set und Operation Requests an: Liste, Lesen per Schlüssel, Anlegen, Ändern und Löschen, soweit das Entity-Set es erlaubt. - Im Collection-Tab SAP systems die Umgebungen DEV, QAS und PRD aus einer Vorlage anlegen: Host, Mandant, Sprache und Benutzer. Das Passwort entsteht als Secret ohne Wert.
- Das Passwort einmal eintragen; es bleibt im Schlüsselbund, die Umgebungsdatei enthält nur den Namen.
- Eine Umgebung wählen und senden. Das Plugin hängt
sap-clientundsap-languagean die URL, wenn sie dort noch nicht stehen.
# environments/QAS.yml
name: QAS
variables:
- name: baseUrl
value: https://s4-qas.example.com
- name: sapClient
value: "200"
- name: sapLanguage
value: EN
- name: user
value: JDOE
- secret: true
name: password
Dieselben Requests laufen so gegen alle drei Systeme; nur Host, Mandant und Benutzer unterscheiden sich.
Entitäten aus $metadata
Der Collection-Tab OData zeigt das Modell des Dienstes: Version, Namespace, Entity-Sets mit Schlüsseln, Eigenschaften, Typen und Beschriftungen, Navigationen und Operationen (Actions und Functions). Das Modell wird je Dienstwurzel zwischengespeichert.

- Kopf: Dienst-URL, Version, Namespace, Zahl der Entity-Sets und Operationen.
- Je Entity-Set die Eigenschaften mit Schlüssel, Edm-Typ und Beschriftung; Hinweise wie no delete, wenn der Dienst etwas nicht erlaubt.
- Create requests schlägt Requests für den Dienst vor; du bestätigst, was angelegt wird. Angelegtes bleibt ungespeichert, bis du speicherst.
- Load $metadata lädt das Modell über die Service root URL, Forget metadata verwirft den Zwischenspeicher.
Abfragen bauen
Im Request-Tab Query baut der Query-Builder aus dem Modell $filter, $expand, $select, $orderby, $top, $skip und $count (V4) bzw. $inlinecount (V2) und schreibt sie in die URL des Requests. Die URL bleibt die Wahrheit; du kannst sie jederzeit von Hand ändern.

Schreiben: CSRF-Token und ETags
SAP Gateway und viele CAP-Deployments schützen schreibende Requests mit einem CSRF-Token, das an das Sitzungs-Cookie gebunden ist. Vor einem POST, PUT, PATCH, MERGE oder DELETE ohne X-CSRF-Token holt das Plugin eines mit X-CSRF-Token: Fetch – in derselben Sitzung wie der Request – und setzt es. Antwortet der Server mit 403 und X-CSRF-Token: Required, holt der nächste Versand ein neues.
Für optimistisches Sperren liest du die Entität zuerst. Das Plugin merkt sich ihr ETag (Header ETag, @odata.etag oder __metadata.etag) und setzt If-Match beim nächsten Ändern oder Löschen dieser Entität, sofern du den Header nicht selbst setzt. In OData V2 ist die Änderungsmethode meist MERGE (neuere Gateway-Releases nehmen auch PATCH), in V4 PATCH.
$batch
Der Tab Batch setzt einen $batch-Request aus lesenden Teilen und Changesets (Gruppen von Schreibzugriffen, die ganz oder gar nicht gelten) zusammen – als Multipart für V2 und V4 oder als JSON für V4 – und zeigt die Antwort Teil für Teil mit Status. Ein Batch ist eine normale Request-Datei; du kannst den Body auch von Hand schreiben.
Drafts in RAP und CAP
Draft-fähige Entitäten haben je Schlüssel zwei Instanzen: die aktive (IsActiveEntity=true) und den Entwurf (IsActiveEntity=false). Der Tab Draft führt durch den Ablauf:
| Schritt | RAP | CAP |
|---|---|---|
| Entwurf einer aktiven Instanz | gebundene Action Edit | gebundene Action draftEdit |
| Entwurf ändern | PATCH auf den Entwurf | PATCH auf den Entwurf |
| Prüfen | Prepare | draftPrepare |
| Sichern | Activate | draftActivate |
| Verwerfen | Discard | DELETE auf den Entwurf |
Lokal ausprobieren und in der Pipeline
Das Repo des Kerns enthält einen synthetischen OData-Testdienst und drei Beispiel-Collections – ohne echte SAP-Daten:
cargo run -p rt-odata-testserver # http://127.0.0.1:47830
examples/s4hana-sales– OData V2 im Stil von SAP Gateway: Kundenaufträge,$expand,MERGE, ein Function-Import,$batchmit Changeset;examples/cap-bookshop– ein CAP-Bookshop als OData V4 mit Drafts und über den V2-Adapter;examples/rap-salesorder– ein RAP-Business-Objekt mit dem ganzen Draft-Ablauf.
Umgebung Local wählen; für die S/4-Beispiele das Test-Passwort RT_PASS als Wert des Secrets password eintragen. Das Plugin läuft auch in rt send, mit derselben CSRF- und ETag-Behandlung:
rt send sales/read-sales-order.yml --env QAS --var password="$QAS_PASSWORD" --plugin odata.wasm --pretty
SAP, SAP S/4HANA und SAP Gateway sind Marken oder eingetragene Marken der SAP SE in Deutschland und anderen Ländern. RequestTailor ist kein Produkt der SAP SE und wird von ihr weder angeboten noch unterstützt.
Siehe auch
- Funktionen im Überblick Funktionen · SAP
- Doku Plugins
- Doku Import
- Doku Umgebungen und Variablen
- Belege plugins/odata/README.md1 · rt-plugin/API.md2