Der Dialog zur Auswahl der Fremddatenverbindung öffnet sich automatisch.
Tragen Sie den Titel der neuen Fremddatengruppe und wählen Sie die SAP Gateway-Datenbankverbindung aus.
In der Auswahlliste "Datahandler" wird bei einer OData-Datenbankverbindung der geeignete Datahandler
automatisch eingetragen. Sie können den Namen der Tabelle bzw. Ansicht direkt eintragen oder auf "Suchen" klicken.
Hilfe zu den weiteren Einstellungen in diesem Dialog finden Sie hier.
Die Datenfelder, die vom OData-Service bereitgestellt werden, können anschließend auf dem
Reiter Datenfelder
ausgewählt und in der Applikation mit den Elementen verbunden werden.
2. Datentypen
Alle Informationen zu diesem Thema finden Sie hier.
3. Referenzen
Alle Informationen zu diesem Thema finden Sie hier.
4. Dateien
4.1. Binäre Datenfelder
OData-Datenfelder vom Typ Edm.Binary (BLOB) werden in Intrexx als File-Datentyp behandelt. Damit lassen sich binäre Daten in
Intrexx-Dateifelder speichern. Da aus OData-Binary-Feldern nicht automatisch ermittelt werden kann, um was für einen
Dateityp es sich handelt, kann in den Expert-Settings des Datenfeldes
der Dateityp hinterlegt werden.
Dieser wird beim Speichern der binären Daten automatisch als Dateinamen-Erweiterung verwendet. Derzeit lässt sich nur ein Dateityp
pro Feld für alle Datensätze definieren. Für den Zugriff und die Manipulation von Dateien bietet OData ab Version 2.0
sogenannte Media-Link-Entries. Diese stellen die empfohlene Methode für den Zugriff auf binäre Daten dar.
Eine weitere Möglichkeit, den Inhalt von binären Feldern als Download zu ermöglichen, besteht über einen Aufruf
der Callable Methode $ODataMediaResourceCallable.getDownloadURIForBinaryProperty(). Diese generiert eine URL,
die auf einer Ansichts- oder Eingabeseite in einem Download-Link eingefügt werden kann:
Mit dieser Methode ist es möglich, den Dateinamen und Content-Type dynamisch zu definieren, indem diese Werte
aus anderen Feldern ermittelt werden.
4.2. Media-Link-Entries
Alle Informationen zu diesem Thema finden Sie
hier.
4.3. Anzeige und Download von Dateien aus Media-Link-Entries
Alle Informationen zu diesem Thema finden Sie
hier.
4.4. Upload von Dateien als Media-Link-Entries
Alle Informationen zu diesem Thema finden Sie
hier.
5. OData-Function-Imports
Neben dem Zugriff auf Entity-Collections (Tabellen) bietet OData auch die Möglichkeit,
sogenannte Function-Imports zu definieren und über den Service auszuführen. Function-Imports lassen sich mit Stored-Procedures
in Datenbankmanagementsystemen vergleichen und können Eingabeparameter empfangen und einen einzelnen
Datensatz oder eine Menge von Datensätze als Ergebnis zurückliefern. Da Intrexx keine direkte Unterstützung
von Stored-Procedures bietet, muss für den Aufruf von Function-Imports folgende Vorgehensweise angewendet werden:
Ermitteln Sie aus den Metadaten des Services den Namen der aufzurufenden Funktion
(z.B. GetProductsWithRating), die benötigten Eingabeparameter, ob das Ergebnis aus einem
Datensatz (OData-Entry) oder einer Ergebnismenge (OData-Entity-Set) besteht und den Entity-Type
(Tabelle in der Intrexx Datengruppe) des Ergebnisses.
Erstellen Sie eine Ansichtsseite für die Parameter der Funktion und eine weitere Seite für die Anzeige
der Ergebnisse des Funktionsaufrufs.
Platzieren Sie auf der Ansichtsseite für die Funktionsparameter pro Parameter ein
Eingabefeld mit
dem entsprechenden Datentyp, aber ohne Verknüpfung,
sowie eine Schaltfläche mit
Sprung auf die Ansichtsseite mit den Ergebnissen.
Erstellen Sie auf der Ergebnisseite eine Ansichtstabelle
(im Falle von einer Ergebnismenge), wählen Sie die entsprechende Datengruppe
(abhängig vom Funktionsergebnistyp) und die anzuzeigenden Datenfelder aus.