Konnektor-Assistent
In der Connector-Aufruf-Übersicht findest du den Connector-Assistenten oben rechts.
Mit dem OData V2-Assistenten ist es einfach, neue Konnektor-Aufrufe basierend auf der angegebenen Endpunkt-URL zu konfigurieren.
Beim Öffnen des Assistenten werden alle verfügbaren Entitätenmengen angezeigt.
Schritt 1: Entitätenmengen auswählen
Wählen Sie im ersten Schritt die erforderlichen Entitätenmengen aus. Die Tabelle auf der linken Seite zeigt alle möglichen Entitätenmengen. Wählen Sie die erforderlichen Entitätenmengen aus und verschieben Sie sie mit den Pfeiltasten in der Mitte in die rechte Tabelle.
Schritt 2: Operationen auswählen
Wählen Sie im zweiten Schritt die Operationen aus, für die Konnektor-Aufrufe erstellt werden sollen. Die linke Tabelle zeigt alle möglichen Operationen für die zuvor ausgewählten Entitätenmengen. Wählen Sie die erforderlichen aus und verschieben Sie sie mit den Pfeiltasten in der Mitte in die rechte Tabelle. Operationen, die bereits einen Konnektor-Aufruf haben, werden fett gedruckt.
Schritt 3: Konnektor-Aufrufe konfigurieren
Im dritten Schritt können Sie den Namen und die Beschreibung der Konnektor-Aufrufe bearbeiten. Erstellen Sie die Konnektor-Aufrufe, indem Sie auf “Konnektor-Aufrufe erstellen” klicken.
Manuelle Konfiguration
Wenn Sie OData v2 Konnektor-Aufrufe ohne den Konnektor-Assistenten erstellen, müssen Sie die folgenden Parameter hinzufügen, abhängig von Ihren OData-Dienstspezifikationen:
| Operation | Die CRUD-Operation für den Aufruf. Z. B. erstellen, aktualisieren, löschen, lesen, alle lesen |
| Pfad | Der OData-Pfad zur jeweiligen Entität |
| optional: key/<keyName> | Für einige Aufrufe müssen Sie einen Schlüssel angeben. Dies könnte z. B. die ID des Objekts sein, das Sie aktualisieren oder löschen möchten |
| optional: <entityName> | Für einige Aufrufe, z. B. beim Erstellen 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 die Entitätenmenge ‘Employee’ erstellt. Die Operation ist 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 von Ihnen verwendeten OData v2-Dienst ab.
Verwenden Sie Abfrageoptionen in OData v2 Konnektor-Aufrufen
In OData v2 Konnektor-Aufrufen können Sie sogenannte Abfrageoptionen 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 aufgenommen werden sollen |
| param/$filter | Fügen Sie eine Filterbedingung für die Anforderung der Daten hinzu, z. B. Name eq ‘Smith’ |
| param/$orderBy | Fügen Sie ein Sortierkriterium 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. Z. B. werden mit einem Skip-Wert von 3 die ersten drei Einträge übersprungen |
| param/$top | Geben Sie die Anzahl der Einträge an, die in der Ausgabe enthalten sein sollen. Z. B. werden mit einem Top-Wert von 3 nur die ersten drei Einträge abgerufen |
Lesen Sie diesen Knowledge-Base-Artikel, um mehr über Abfrageoptionen zu erfahren: https://community.simplifier.io/knowledge/how-to-use-query-options-in-odatav2-connector/
Sie können hier nachlesen, wie Sie den Konnektor in einer Anwendung verwenden und adressieren: Create an ODataV2 Connector.
