RequestTailor Vorschau (22.11.2026): Requests als Dateien in Git, ohne Konto, offline – auf dem Mac, im Browser und in der Pipeline. Was drin ist → +43 664 1964199Kontakt →

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. 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 sapClient und sapLanguage.
DienstTypische WurzelProtokoll
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

  1. Eine Collection anlegen oder die $metadata des Dienstes importieren – vom System oder als API-Spezifikation aus dem SAP Business Accelerator Hub (EDMX oder OpenAPI mit x-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.
  2. 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.
  3. Das Passwort einmal eintragen; es bleibt im Schlüsselbund, die Umgebungsdatei enthält nur den Namen.
  4. Eine Umgebung wählen und senden. Das Plugin hängt sap-client und sap-language an 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.

Collection-Tab OData des Dienstes ZRT_SALES_SRV, Version V2: Entity-Sets SalesOrderSet, SalesOrderItemSet und CustomerSet mit Schlüsseln, Edm-Typen und Beschriftungen, Navigationen ToItems und ToCustomer, zwei Operationen und Knöpfe Create requests, Forget metadata und Load $metadata
Das Modell eines OData-V2-Dienstes aus dem lokalen Testdienst, mit erfundenen Daten.
  1. Kopf: Dienst-URL, Version, Namespace, Zahl der Entity-Sets und Operationen.
  2. Je Entity-Set die Eigenschaften mit Schlüssel, Edm-Typ und Beschriftung; Hinweise wie no delete, wenn der Dienst etwas nicht erlaubt.
  3. Create requests schlägt Requests für den Dienst vor; du bestätigst, was angelegt wird. Angelegtes bleibt ungespeichert, bis du speicherst.
  4. 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.

Tab Query des Requests Read sales order with items: Service root, Entity set SalesOrderSet, OData-Version V2 aus $metadata, Tabelle der filterbaren Eigenschaften mit Typ und Beispielfilter, darunter die Antwort 200 OK mit dem Auftrag samt ToCustomer
Der Query-Builder zeigt die filterbaren Eigenschaften mit einem Beispiel je Typ; die Antwort darunter enthält die per $expand geladenen Kunden- und Positionsdaten.

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:

SchrittRAPCAP
Entwurf einer aktiven Instanzgebundene Action Editgebundene Action draftEdit
Entwurf ändernPATCH auf den EntwurfPATCH auf den Entwurf
PrüfenPreparedraftPrepare
SichernActivatedraftActivate
VerwerfenDiscardDELETE 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, $batch mit 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

Fundstellen auf dieser Seite

Die hochgestellten Ziffern im Text verweisen hierher. Antippen zeigt die Fundstelle direkt an der Textstelle, alle Fundstellen der Website stehen gesammelt auf einer Seite.

  1. 1

    OData-Plugin für S/4HANA, CAP und RAP ↑Produkt · Repo des Kerns von RequestTailor, plugins/odata, website/sap, website/docs/odata · geprüft am 22.11.2026

  2. 2

    Plugins nur als WebAssembly, mit Rechten ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-plugin/API.md, plugins/README.md · geprüft am 22.11.2026

Häufige Fragen

Kurz beantwortet.

Ist RequestTailor ein SAP-Produkt?
Nein. RequestTailor ist ein API-Client der CloudDNA GmbH. Der Kern enthält kein SAP-Wissen; OData und SAP stecken im OData-Plugin auf der öffentlichen Plugin-API, das du beim ersten Start wählst.
Brauche ich ein SAP-System, um das Plugin auszuprobieren?
Nein. Das Repo des Kerns enthält den synthetischen Testdienst rt-odata-testserver und drei Beispiel-Collections für S/4HANA, CAP und RAP mit erfundenen Daten.
Wo liegt mein SAP-Passwort?
Im Schlüsselbund deines Betriebssystems, in der Web-App verschlüsselt im Browser. Die Umgebungsdatei im Repo enthält nur den Namen der Variable, nie den Wert.
Gibt es Unterstützung für BTP-Destinations und Service-Keys?
Noch nicht. Komfort für die SAP BTP ist für Pro geplant und in Arbeit. Bis dahin trägst du Host und Zugangsdaten als Umgebung ein, etwa mit OAuth 2.0 Client Credentials.

Deine Frage ist nicht dabei? Sprich mich an: +43 664 1964199 office@clouddna.at Schreib mir

Kontakt

Requests im Repo statt im Konto? Sprich mit uns.

Free ist kostenlos und bleibt es. Für eine Vorabversion, für Enterprise, für das OData-Plugin an eurem SAP-System oder für einen Wunsch an Pro und Team: Schreib mir. Ich antworte innerhalb eines Werktags, persönlich.

Martin KochGeschäftsführer, CloudDNAIch lese jede Anfrage selbst und antworte persönlich.