Funktion

Beispiele und Erläuterungen

Mit InputAssistant plus GuiXT Controls steht Ihnen eine komfortable Möglichkeit zur Verfügung, SAP OData Services in GuiXT zu nutzen. Insbesondere in neueren SAP Systemen sind zahlreiche OData-Services durch SAP implementiert; diese bilden auch die Grundlage der Fiori Apps. GuiXT unterstützt die aktuell genutzten OData-Versionen v2 und v4.

Alle erforderlichen Berechtigungsprüfungen hat SAP bereits in die Sevices integriert, sodass kein Risiko besteht, dem Benutzer Daten anzuzeigen oder durch ihn ändern zu lassen, für die er nicht autorisiert ist.

Auf der Website "SAP Business Accelerator Hub" stellt SAP einen Katalog aller OData Services zur Verfügung.

Das OData Tool des GuiXT Script Editor Pro enthält eine komfortable Suchfunktion, ein Live-Preview der Inhalte sowie die automatische Generierung der OData Aufrufe für Ihre Scripte. 

Neben den OData-Services des SAP Standards können Sie auch selbstentwickelte Services aufrufen.

In GuiXT sind alle OData "CRUD"  Operationen (Create, Read, Update, Delete) unterstützt:
  • Hinzufügen einer Entität: guinet.odata.create
  • Lesen einer oder mehrerer Entitäten: guinet.odata.read
  • Ändern einer Entität: guinet.odata.update
  • Löschen einer Entität: guinet.odata.delete

Zusätzlich gibt es die Funktionen

  • Anmelden einer OData Session: guinet.odata.logon
  • Abmelden einer OData Session: guinet.odata.logout
  • Ausführen einer Aktion guinet.odata.execute

Die Dokumentation aller Aufrufe finden Sie in

GuiXT API for SAP OData Services

Ausführliche Beispiele zu einzelnen Themen dann dort im Anschluss in separaten Artikeln.

Beispiel 1
Lesen aller Instandhaltungsaufträge zu einem Datum
CreateTable V[myorders] _
  MaintenanceOrder _
  MaintenanceOrderType _
  MaintenanceOrderDesc _
  MaintOrdBasicStartDate

CallVB guinet.odata.read _
  service:="sap/opu/odata/sap/API_MAINTENANCEORDER/
                     MaintenanceOrder" _
  filter:="MaintOrdBasicStartDate eq 04.04.2025" _
  result:="myorders" 


Ergebnis V[myorders]:
4001320	YBA1	Equipment Repair (T&M)		04.04.2025
4001321	YBA1	Pump Service			04.04.2025
4001322	YBA1	Equipment Repair (Fixed Price)	04.04.2025
4001323	YBA1	Follow-on for 4001322		04.04.2025
4001324	YBA1	Equipment Repair (Fixed Price)	04.04.2025

                                         
Logon
Ein expliziter Logon-Aufruf ist in der Regel nicht nötig, da GuiXT bei der ersten OData-Operation pro SAP GUI Session automatisch intern den Logon durchführt.
Der Servername für die https-Odata-Verbindung wird dabei dem GuiXT Profile bzw. der "guixt.ini" Datei entnommen, Parameter "ODataServer". Zur Authentifizierung des Benutzers werden Benutzername und Passwort der laufenden SAP GUI Session verwendet.
Falls die SAP GUI-Anmeldung über SSO geschieht, können Sie durch den Zusatz "authmode=sso" in der Angabe des ODATA Servers erreichen, dass GuiXT stattdessen eine andere Authentifizierungsmethode wählt.
Die Authentifizierungsmethoden OAuth 2.0, SAML und X.509 Client-Zertifikate werden, falls konfiguriert, automatisch durch Windows benutzt.

Sie können mit einem expliziten Logon-Aufruf arbeiten, zum Beispiel wenn Sie eine OData-Verbindung zu einem anderen SAP System aufbauen wollen, um Daten des aktuellen Systems mit einem anderen System zu vergleichen.
Eine eventuell schon bestehende Verbindung wird durch einen expliziten Logon geschlossen.

Beipiel einer Anmeldung:

Anmelden einer OData Session
CallVB guinet.odata.logon _
  server:="abc.com" _
  authmode:="sso"
Beispiel 2
Lesen einer Länderbezeichnung
// define result structure
CreateStructure V[countrytext] _
    Country CountryName NationalityName

// OData call
CallVB guinet.odata.read _
  service:="sap/opu/odata/sap/API_COUNTRY_SRV/A_CountryText" _
  filter:="Country eq 'IT' and Language eq 'EN'" _
  result:="countrytext" 


Ergebnis V[countrytext]:
IT  Italy   Italian
Beispiel 3
Lesen eines Instandhaltungsauftrags mit den Vorgängen
CreateStructure V[myorder] _
    MaintenanceOrder _
    MaintenanceOrderType _
    MaintenanceOrderDesc _
    MaintOrdBasicStartDate

CreateTable V[myoperations] _
    MaintenanceOrder _
    MaintenanceOrderOperation _
    Plant _
    WorkCenter _
    OperationDescription _
    MaintOrderOperationDuration _
    MaintOrdOperationDurationUnit

CallVB guinet.odata.read _
  service:="sap/opu/odata/sap/API_MAINTENANCEORDER/
         MaintenanceOrder('4001324')" _
  expand:="to_MaintenanceOrderOperation" _
  result:="myorder,myoperations" 


Ergebnis V[myorder]:
4001324 YBA1    Equipment Repair (Fixed Price)  04.04.2025
V[myoperations]:
4001324	0010	1710	RES-0500	Dismantle	1,0	STD
4001324	0020	1710	RES-0500	Repair		5,0	STD
4001324	0030	1710	RES-0500	Assemble	2,0	STD
                    
Berechtigungen und Sicherheitsmodell GuiXT OData verwendet keinen eigenen technischen Service-Benutzer für den Zugriff auf SAP S/4HANA. Sämtliche Requests laufen im Benutzerkontext des jeweils angemeldeten Endanwenders – die Bibliothek reicht dessen Anmeldedaten unverändert an den SAP-Gateway-Server weiter. Das SAP-Backend führt daher exakt dieselben Berechtigungsprüfungen durch wie bei jedem anderen HTTP-Client, der sich mit denselben Zugangsdaten am selben OData-Service anmeldet – etwa ein Web-Browser oder ein Tool wie Postman. Dazu gehören insbesondere:
  • die Startberechtigung für den OData-Service selbst (Berechtigungsobjekt S_SERVICE),
  • alle im Service implementierten AUTHORITY-CHECK- bzw. @AccessControl-Prüfungen auf Datenebene,
  • sämtliche feld- und zeilenbezogenen Einschränkungen (z. B. Werks-, Belegarten- oder Kostenrechnungskreis-Berechtigungen).

GuiXT OData selbst implementiert keine eigene Berechtigungslogik und filtert oder verändert keine Anfragen auf eine Weise, die über das hinausgeht, was der Endanwender auch über einen direkten Zugriff auf denselben OData-Service anfordern könnte. Die Bibliothek stellt technisch lediglich einen alternativen HTTP-Client dar; die Berechtigungshoheit verbleibt vollständig beim SAP-Gateway und -Backend.

Verifizierbarkeit: Diese Eigenschaft lässt sich pro Service konkret nachweisen, indem ein Testaufruf über GuiXT OData mit aktivem SAP-Berechtigungstrace (Transaktion ST01 bzw. Auswertung über SU53 nach einem fehlgeschlagenen Zugriff) durchgeführt und mit einem äquivalenten Aufruf über einen Browser oder das SAP Gateway Client Tool (/IWFND/GW_CLIENT) verglichen wird. Beide Zugriffswege lösen dieselben Berechtigungsprüfungen aus.
Komponente InputAssistant + GuiXT Controls