Die Aktivität „OData Service“ kann so konfiguriert werden, dass Daten aus zwei verschiedenen Arten von Datenquellen gelesen, geschrieben, aktualisiert oder gelöscht werden:
- Datenbankintegration: Verbinden Sie sich mit Datenbanken, die von Simplifier DB Designer bereitgestellt werden, ohne SQL-Anweisungen schreiben zu müssen
- OData Service Integration: Stellen Sie mithilfe von OData-Konnektoren eine Verbindung zu SAP OData-Diensten (v2 und v4) her
Technisch basiert die Lösung auf dem OData-Protokoll – offen und State-of-the-Art. Für die Datenbankintegration wird OData v4 verwendet, um eine standardisierte Schnittstelle bereitzustellen, während OData Service Integration sowohl v2 als auch v4 unterstützt, abhängig vom Zielsystem.
Sie finden die Aktivität im linken Menü des Prozessdesigners unter „OData Service“.
Die OData-Version (v2 oder v4) wird automatisch basierend auf Ihrer Datenauswahl erkannt. Beachten Sie, dass einige Funktionen je nach verwendeter OData-Version ein unterschiedliches Verhalten aufweisen können.
Wichtige Hinweise:
- Unsere OData-Servicefunktion wurde für die Integration von SAP entwickelt. OData-Dienste für andere Backends funktionieren möglicherweise auch, aber wir können dies nicht garantieren.
- Für die Konfiguration der Form ruft der Prozessdesigner die Metadaten von SAP über den ausgewählten OData-Konnektor ab. Stellen Sie sicher, dass der Konnektor das SAP-System in der jeweiligen Entwicklungsumgebung erreichen und sich dort authentifizieren kann.
- Derzeit erfolgt das Monitoring für Datenbanken und SAP OData-Dienste unterschiedlich: Für Datenbanken wählen Sie „OData Service“ als Artefakttyp aus, während Sie für SAP OData-Dienste den jeweiligen OData-Konnektor auswählen.
- Aufgrund der Art und Weise, wie OData-Modelle in UI5 behandelt 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 ‘Datensatz laden’ liest eine Liste von Daten aus Ihrer Datenquelle und zeigt sie in geeigneten Widgets an, die die Ansicht von Listenelementen (technisch Aggregationen) unterstützen, wie z. B. einem Listen- oder Tabellen-Widget.
Die Form kann auch verwendet werden, um eine Liste von Datensätzen nach der Bearbeitung einer Entität neu zu laden.
Der ausgewählte Entitätssatz bestimmt, welche Datenentität geladen wird:
- Für die Datenbankintegration: Datenbanktabelle aus Ihrem bereitgestellten Schema
- Für die OData Service Integration: Entitätssatz aus dem SAP OData-Dienst
Nachdem Sie Ihre Datenquelle (Datenbankschema oder OData-Konnektor) und Ihren Entitätssatz ausgewählt haben, müssen Sie die Ausgabezuordnungen der Aktivität zu einer Datenaggregation eines UI-Widgets konfigurieren: Ordnen Sie den Entitätssatz der Aggregationseigenschaft des Widgets zu und verwenden Sie dann den Binding Editor, um die Eigenschaften jeder Entität 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
- Eingeschränkte Erweiterungsmöglichkeiten im Vergleich zu v4:
- Nur eine Erweiterungsebene möglich
- 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, muss die eindeutige Kennung (Primärschlüsselfelder der Entität) als Parameter-Eingabezuordnungen bereitgestellt werden.
Die Eingabezuordnungen der Aktivität müssen so konfiguriert sein, dass sie alle erforderlichen ID-Eigenschaften des ausgewählten Datensatzes enthalten:
- Für die Datenbankintegration: Primärschlüsselspalten der Datenbanktabelle
- Für die OData Service Integration: Schlüsselfelder, wie in den SAP OData-Dienstmetadaten definiert
In der Konfiguration der Ausgabezuordnungen können alle Felder des ausgewählten Datensatzes Eigenschaften von UI-Widgets zugeordnet werden.
Im Beispiel enthält das ‘DetailsPanel’ die UI-Widgets, die schließlich zugeordnet werden sollen.
Sie können dann durch die Widget-Struktur navigieren und die Eigenschaft auswählen, um sie zu den ‘Ausgewählten Eigenschaften’ hinzuzufügen.
Die ausgewählten Eigenschaften stehen dann für die Zuordnung 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
- Eingeschränkte Erweiterungsmöglichkeiten im Vergleich zu v4:
- Nur eine Erweiterungsebene möglich
- Namen der zu erweiternden Navigationseigenschaften müssen explizit eingegeben werden
Um einen neuen Datensatz zu erstellen, muss die OData Service-Form 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 über den SQL-Konnektor
– Für die OData Service Integration: Direkt an den SAP OData-Dienstendpunkt über den OData-Konnektor
Es ist wichtig, dass die Daten korrekt formatiert sind.
Die Ausgabezuordnung der Aktivität zum Erstellen von Daten enthält die neu erstellte Entität mit allen 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):
– Volle 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 deaktiviert 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 den bereitgestellten ID-Feldern wird aus Ihrer Datenquelle entfernt:
– Für die Datenbankintegration: Der Datensatz wird aus der Datenbanktabelle gelöscht
– Für die OData Service Integration: Die Entität wird über den OData-Dienst aus dem SAP-System gelöscht
Eine als „Daten schreiben“ konfigurierte OData Service-Aktivität aktualisiert Datensätze in Ihrer Datenquelle:
– Für die Datenbankintegration: Aktualisiert Datenbankdatensätze über DB Designer
– Für die OData Service Integration: Aktualisiert Entitäten im SAP OData-Dienst
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 Aktualisierungen
OData v2 (nur SAP): Beschränkt auf die Aktualisierung des gesamten Datensatzes; kann nicht auf den Entitätssatz beschränkt werden
Die Aktivität ‘Änderungen zurücksetzen’ verwirft die an Datensätzen vorgenommenen Änderungen, bevor Sie sie in Ihrer Datenquelle aktualisieren oder erstellen, und setzt daher die Werte auf die anfänglich geladenen Werte zurück.
Diese Operation funktioniert mit beiden Datenquellentypen:
– Für die Datenbankintegration: Setzt Änderungen vor dem Datenbank-Commit zurück
– Für die OData Service Integration: Setzt Änderungen zurück, bevor Aktualisierungen an den SAP OData-Dienst 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): Die Zurücksetzungsoperation gilt für das gesamte Modell, nicht nur für bestimmte Entitätssätze
Anwendungsszenarien
– Benutzerbearbeitungen ohne Speichern abbrechen
– Ursprüngliche Werte nach Validierungsfehlern wiederherstellen
Mit der Konfiguration ‘Funktion / Aktion aufrufen’ können Sie auf Funktionen und Aktionen zugreifen, die vom ausgewählten OData-Konnektor bereitgestellt werden.
