Die Aktivität “OData Service” kann zum Lesen, Schreiben, Aktualisieren oder Löschen von Daten aus zwei verschiedenen Arten von Datenquellen konfiguriert werden:
- Datenbank-Integration: Verbinden Sie sich mit Datenbanken, die von Simplifier DB Designer bereitgestellt werden, ohne SQL-Anweisungen zu schreiben.
- OData-Dienst-Integration: Verbindung zu SAP OData-Diensten (v2 und v4) über OData-Konnektoren
Technisch basiert die Lösung auf dem OData-Protokoll – offen und modern. Für die Datenbankintegration wird OData v4 verwendet, um eine standardisierte Schnittstelle bereitzustellen, während OData Service Integration je nach Zielsystem sowohl v2 als auch v4 unterstützt.
Sie finden die Aktivität im linken Menü des Prozessdesigners unter “OData Service”.
Die OData-Version (v2 oder v4) wird automatisch anhand der von Ihnen gewählten Datenquelle erkannt. Beachten Sie, dass sich einige Funktionen je nach der verwendeten OData-Version unterschiedlich verhalten können.
Wichtige Hinweise:
- Unsere OData Service Funktion ist für die Integration von SAP entwickelt worden. OData Services für andere Backends könnten auch funktionieren, aber wir können es nicht garantieren.
- Für die Konfiguration des Shapes holt sich der Prozessdesigner die Metadaten von SAP über den ausgewählten OData-Konnektor. Stellen Sie sicher, dass der Konnektor in der Lage ist, das SAP-System auf der jeweiligen Entwicklungsinstanz zu erreichen und sich dort zu authentifizieren.
- Derzeit wird die Überwachung für Datenbanken und SAP OData Services unterschiedlich durchgeführt: Für Datenbanken wählen Sie als Artefakttyp “OData Service” aus, während Sie für SAP OData Services den jeweiligen OData Connector auswählen.
- Aufgrund der Art und Weise, wie OData-Modelle in UI5 gehandhabt werden, kann das anfängliche Laden eines Entitätssatzes eines OData-Dienstes zum anfänglichen Laden eines anderen Entitätssatzes desselben Dienstes führen, wenn auch für diesen anderen Entitätssatz eine Datenbindung definiert ist.
Die Konfiguration “Load Dataset” liest eine Liste von Daten aus Ihrer Datenquelle und zeigt sie in geeigneten Widgets an, die die Ansicht von Listenelementen (technisch gesehen Aggregationen) wie ein Listen- oder Tabellen-Widget unterstützen.
Die Form kann auch verwendet werden, um eine Liste von Datensätzen nach dem Bearbeiten eines Objekts neu zu laden.
Der ausgewählte Entitätssatz bestimmt, welche Datenentität geladen wird:
- Für die Datenbankintegration: Datenbanktabelle aus dem von Ihnen verwendeten Schema
- Für OData Service Integration: Entitätsmenge aus dem SAP OData Service
Nach der Auswahl der Datenquelle (Datenbankschema oder OData-Konnektor) und des Entity-Sets müssen Sie die Output-Mappings der Aktivität auf eine Datenaggregation eines UI-Widgets konfigurieren: Ordnen Sie das Entitätsset der Aggregationseigenschaft des Widgets zu und verwenden Sie dann den Bindungseditor, um die Eigenschaften der einzelnen Entitäten zu binden.
Überlegungen zur OData-Version
OData v4 (Datenbank und SAP):
- Auto-Commit-Funktionalität für Datenänderungen verfügbar
- Volle Unterstützung für die automatische Erweiterung von Entitätsbeziehungen
OData v2 (nur SAP):
- Auto-commit wird nicht unterstützt
- Begrenzte Erweiterungsmöglichkeiten im Vergleich zu v4:
- Nur eine Ausbaustufe möglich
- Die Namen der zu erweiternden Navigationseigenschaften müssen explizit eingegeben werden
Mit der Einstellung “Daten laden” können Sie einen einzelnen Datensatz laden und in einem UI-Widget wie einem Formular oder Textlayout anzeigen.
Um einen einzelnen Datensatz (Entität) zu laden, müssen die eindeutigen Bezeichner (Primärschlüsselfelder der Entität) als Parameter-Eingangsmappings bereitgestellt werden.
Die Eingangsmappings der Aktivität müssen so konfiguriert werden, dass sie alle erforderlichen ID-Eigenschaften des gewählten Datensatzes enthalten:
- Für die Datenbankintegration: Primärschlüsselspalten der Datenbanktabelle
- Für OData Service Integration: Schlüsselfelder wie in den Metadaten des SAP OData Service definiert
In der Konfiguration der Output-Mappings können alle Felder des gewählten Datensatzes auf Eigenschaften von UI-Widgets abgebildet werden.
Im Beispiel enthält das “DetailsPanel” die UI-Widgets, die schließlich zugeordnet werden sollen.
Sie können dann durch den Widget-Baum navigieren und die Eigenschaft auswählen, um sie zu den “ausgewählten Eigenschaften” hinzuzufügen.
Die ausgewählten Eigenschaften stehen dann für das Mapping zur Verfügung.
Überlegungen zur OData-Version
OData v4 (Datenbank und SAP):
- Auto-Commit-Funktionalität für Datenänderungen verfügbar
- Volle Unterstützung für die automatische Erweiterung von Entitätsbeziehungen
OData v2 (nur SAP):
- Auto-commit wird nicht unterstützt
- Begrenzte Erweiterungsmöglichkeiten im Vergleich zu v4:
- Nur eine Ausbaustufe möglich
- Die Namen der zu erweiternden Navigationseigenschaften müssen explizit eingegeben werden
Um einen neuen Datensatz zu erstellen, muss die Form des OData-Dienstes als “Daten erstellen” konfiguriert werden.
In den Eingabezuordnungen können die Felder des Datensatzes mit Daten gefüllt werden, die von Widgets oder Variablen bereitgestellt werden.
Die neuen Daten werden an das Zielsystem gesendet:
– Für die Datenbankintegration: Über die OData-Schnittstelle des DB Designers durch den SQL Connector
– Für OData Service Integration: Direkt an den SAP OData Service Endpunkt über den OData Connector
Es ist wichtig, dass die Daten korrekt formatiert sind.
Das Ausgabe-Mapping der Aktivität zum Erstellen von Daten enthält die neu erstellte Entität mit all ihren Eigenschaften, die Variablen oder UI-Widgets zur Anzeige oder weiteren Verwendung zugeordnet werden können.
Überlegungen zur OData-Version
OData v4 (Datenbank und SAP):
– Vollständige Auto-Commit-Funktionalität verfügbar
– Gruppen-ID-Feld für Batch-Operationen unterstützt
OData v2 (nur SAP):
– Auto-Commit ist immer aktiviert und kann nicht ausgeschaltet werden
– Kein Gruppen-ID-Feld verfügbar
Um einen Datensatz zu löschen, müssen Sie die OData Service-Aktivität als ‘Daten löschen’ konfigurieren.
Der Datensatz der Entität mit dem/den angegebenen ID-Feld(ern) wird aus Ihrer Datenquelle entfernt:
– Für Datenbankintegration: Datensatz wird aus der Datenbanktabelle gelöscht
– Für OData Service Integration: Die Entität wird aus dem SAP-System über den OData-Service gelöscht
Eine OData Service-Aktivität, die als “Daten schreiben” konfiguriert ist, aktualisiert Datensätze in Ihrer Datenquelle:
– Für Datenbankintegration: Aktualisiert Datenbankeinträge über DB Designer
– Für OData Service Integration: Aktualisiert Entitäten im SAP OData Service
Mit den Eingabezuordnungen können Sie angeben, welche Felder mit neuen Werten aus Widgets oder Variablen aktualisiert werden sollen.
Die eindeutige Kennung (Schlüsselfelder) muss angegeben werden, um den zu aktualisierenden Datensatz zu identifizieren.
Überlegungen zur OData-Version
OData v4 (Datenbank und SAP): Unterstützung für partielle Updates
OData v2 (nur SAP): Begrenzt auf die Aktualisierung des gesamten Datenbestands; kann nicht auf die Entitätsmenge beschränkt werden
Die Aktivität “Änderungen zurücksetzen” verwirft die Änderungen, die an den Datensätzen vorgenommen wurden, bevor Sie sie in Ihrer Datenquelle aktualisieren oder erstellen, und setzt daher die Werte auf die ursprünglich geladenen Werte zurück.
Dieser Vorgang funktioniert mit beiden Datenquellentypen:
– Für Datenbankintegration: Setzt Änderungen vor der Datenbankübergabe zurück
– Für OData Service Integration: Setzt Änderungen zurück, bevor Aktualisierungen an den SAP OData Service gesendet werden
Überlegungen zur OData-Version
OData v4 (Datenbank und SAP): Granulare Kontrolle darüber, welche Änderungen zurückgesetzt werden sollen
OData v2 (nur SAP): Reset-Operation gilt für das gesamte Modell, nicht nur für bestimmte Entity-Sets
Verwendungsszenarien
– Benutzerbearbeitungen ohne Speichern abbrechen
– Wiederherstellung der ursprünglichen Werte nach fehlgeschlagener Validierung
Mit der Konfiguration ‘Call Function / Action’ können Sie auf Funktionen und Aktionen zugreifen, die von dem gewählten OData Connector bereitgestellt werden.
