Konnektor-Assistent
In der Übersicht über Connector-Anrufe finden Sie den Connector Wizard in der oberen rechten Ecke. Mit dem OData V2-Assistenten ist es einfach, neue Connectoraufrufe basierend auf der angegebenen Endpunkt-URL zu konfigurieren.
Beim Öffnen des Assistenten werden alle verfügbaren Entitätsmengen angezeigt.
Schritt 1: Auswählen von Entitätsmengen Wählen Sie im ersten Schritt die gewünschten Entitätsmengen aus.
Die Tabelle auf der linken Seite zeigt alle möglichen Entitätsmengen.
Wählen Sie die gewünschten Entitätsmengen aus und verschieben Sie sie mit den Pfeiltasten in der Mitte in die rechte Tabelle.
Schritt 2: Vorgänge auswählen Wählen Sie im zweiten Schritt die Vorgänge aus, für die Connectoraufrufe erstellt werden sollen.
Die linke Tabelle zeigt alle möglichen Operationen für die zuvor ausgewählten Entitätsmengen.
Wählen Sie die gewünschten aus und verschieben Sie sie mit den Pfeiltasten in der Mitte an die richtige Tabelle.
Vorgänge, die bereits über einen Konnektoraufruf verfügen, werden fett gedruckt.
Schritt 3: Konfigurieren von Connectoranrufen Im dritten Schritt können Sie den Namen und die Beschreibung der Konnektoraufrufe bearbeiten.
Erstellen Sie die Konnektor-Anrufe, indem Sie auf “Konnektor-Anrufe erstellen” klicken.
Manuelle Konfiguration
Wenn Sie OData v2-Connectoraufrufe ohne den Connector-Assistenten erstellen, müssen Sie abhängig von Ihren OData-Dienstspezifikationen die folgenden Parameter hinzufügen:
| Operation | Der CRUD-Vorgang für den Aufruf. Z.B. erstellen, aktualisieren, löschen, lesen, lesenAlle |
| path | Der OData-Pfad zur jeweiligen Entität |
| optional: key/<keyName> | Bei einigen Anrufen müssen Sie einen Schlüssel angeben. Dies kann z. B. die ID des Objekts sein, das Sie aktualisieren oder löschen möchten |
| optional: <entityName> | Bei einigen Aufrufen, z.B. beim Anlegen einer neuen Entität, müssen Sie die Daten für die neue Entität an die Datenbank senden. Der Datentyp hängt hier von den OData-Spezifikationen für diese Entität ab |
Im obigen Screenshot wird eine neue Entität für den Entitätssatz “Mitarbeiter” erstellt.
Der Vorgang lautet also “create”, und wir senden die EmployeeID als Schlüssel sowie die Daten des neuen Mitarbeiters als separate Parameter.
Die erforderlichen Parameter hängen jedoch immer von dem OData v2-Service ab, den Sie verwenden.
Verwenden von Abfrageoptionen in OData v2-Connectoraufrufen
In OData v2 Connector Calls können Sie sogenannte Query Options als Eingabeparameter verwenden, um die abgerufenen Daten weiter zu filtern/erweitern/manipulieren.
Die folgenden Parameter werden unterstützt:
| param/$expand | Geben Sie an, welche der zugehörigen Ressourcen in das Ergebnis einbezogen werden sollen |
| param/$filter | Fügen Sie eine Filterbedingung für die Abfrage der Daten hinzu, z. B. Name eq ‘Smith’ |
| param/$orderBy | Fügen Sie ein Bestellkriterium für die angeforderten Daten hinzu, z.B. UnitsInStock desc |
| param/$select | Geben Sie an, welche Eigenschaften der Ressource angefordert werden sollen |
| param/$skip | Geben Sie die Anzahl der Einträge an, die übersprungen werden sollen. Bei einem Skip-Wert von 3 werden z.B. die ersten drei Einträge übersprungen |
| param/$top | Geben Sie die Anzahl der Einträge an, die in der Ausgabe enthalten sein sollen. Bei einem Spitzenwert von 3 werden z.B. nur die ersten drei Einträge abgerufen |
In diesem Knowledge Base-Artikel erfahren Sie mehr über Abfrageoptionen: https://community.simplifier.io/knowledge/how-to-use-query-options-in-odatav2-connector/ Sie können lesen, wie Sie den Connector in einer Anwendung verwenden und adressieren: Erstellen eines ODataV2-Connectors.
