OData-Verbindung

Einführung

Eine OData-Verbindung, die mit dem OData-Connector erstellt wurde, ermöglicht den Zugriff auf OData-Endpunkte. Sobald eine Verbindung konfiguriert ist, können Instanzen von OData-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind und entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Erstellen oder Bearbeiten einer OData-Verbindung

Eine neue OData-Verbindung wird mit dem OData-Connector von einem dieser Standorte erstellt:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

Eine vorhandene OData-Verbindung kann von diesen Standorten bearbeitet werden:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Registerkarte Komponenten im Projektbereich (siehe Menü für Komponentenaktionen in Projektbereich Komponentenregister).
• Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).

Konfigurieren einer OData-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die OData-Verbindung wird im Folgenden beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede OData-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den OData-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

• OData-Metadaten-URL: Geben Sie die OData-Endpunkt-$metadata-URL ein.

  Hinweis

  Abhängig von Ihrem gewählten OData-Endpunkt sind möglicherweise erforderliche Daten nicht über die Standard-Metadaten-URL zugänglich. Beispielsweise muss beim Verbinden mit einem Dynamics 365 OData-Endpunkt eine Filterklausel (?$filter=dataAreaId eq 'usrt'&cross-company=true) an die Metadaten-URL angehängt werden, um den Abfragebereich zu erweitern. Die Verwendung von ?cross-company=true ohne eine Filterklausel ist nicht ausreichend.

  Konsultieren Sie die Dokumentation Ihres Endpunkts für ähnliche Hinweise.

• OData-Version: Wählen Sie die von dem OData-Endpunkt unterstützte OData-Version, entweder V4 (Standard) oder V2.

• Authentifizierung: Wählen Sie die Authentifizierungsmethode, eine von Keine Authentifizierung, Basis-Auth oder OAuth2:

  • Keine Authentifizierung: Der Zugriff auf den OData-Endpunkt erfolgt anonym ohne Autorisierung.

  • Basis-Auth: Erweitert zusätzliche Konfigurationsoptionen, bei denen Sie einen Benutzernamen und ein Passwort angeben, die für die Basisautorisierung verwendet werden:

    • Benutzername: Geben Sie einen gültigen Benutzernamen ein.

• Passwort: Geben Sie ein gültiges Passwort ein.

  • OAuth2: Erweitert zusätzliche Optionen zur Konfiguration von OAuth 2.0:

    • Grant-Typen: Wählen Sie Client Credentials oder Password Grant als Grant-Typ für die OAuth-Authentifizierung. Client Credentials ist standardmäßig ausgewählt, aber Benutzer können einen zusätzlichen Benutzernamen und Passwort angeben, wenn Password Grant ausgewählt ist.

    • OAuth-Token-Endpunkt: Geben Sie den OAuth-Token-Endpunkt ein.

    • Client-ID: Geben Sie die Client-ID ein.

    • Client-Geheimnis: Geben Sie das Client-Geheimnis ein.

    • Benutzername: Geben Sie einen gültigen Benutzernamen ein. Sichtbar nur, wenn der Grant-Typ auf Password Grant gesetzt ist.

    • Passwort: Geben Sie ein gültiges Passwort ein. Sichtbar nur, wenn der Grant-Typ auf Password Grant gesetzt ist.

    • Bereich: Geben Sie den Bereich ein.

    • Token-Typ: Geben Sie den Token-Typ ein.

    • Client-Authentifizierung: Wählen Sie die Methode, mit der die Client-Authentifizierung in der Anfrage gesendet wird. Die Authentifizierung kann als Send as Basic Auth header oder Send client credentials in body gesendet werden.

• Erweiterte HTTP-Eigenschaften: Definieren Sie HTTP-Header für die Verbindung. Das OData-Protokoll akzeptiert standardmäßige HTTP-Header, die in Rfc 2616 (Abschnitt 14) definiert sind, sowie benutzerdefinierte Header, die spezifisch für den Endpunkt sind. Klicken Sie auf das Hinzufügen-Symbol , um einen Header zur Tabelle unten hinzuzufügen, und geben Sie ein Schlüssel-Wert-Paar für jeden Anfrageparameter ein.

  Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der rechten Spalte.

  Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie mit der Maus über die rechte Spalte und verwenden Sie das Bearbeiten-Symbol oder das Löschen-Symbol .

  Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

  Hinweis

  Benutzerdefinierte Header müssen im Endpunkt konfiguriert werden, damit dieser sie als Teil dieser Anfrage akzeptiert. Wenn Sie Microsoft Azure verwenden, um Ihren OData-Endpunkt zu verwalten, lesen Sie die Microsoft-Dokumentation zu Benutzerdefinierten Headern in Zugriff auf Endpunkte, die Authentifizierung erfordern.

  Wichtig

  Felder in der Tabelle der erweiterten HTTP-Eigenschaften zeigen das Variablen-Icon nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

  Felder in der Tabelle der erweiterten HTTP-Eigenschaften unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

• Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe, die mit der aktuellen Umgebung verbunden ist, heruntergeladen. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Auto Connector Update deaktivieren.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine OData-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Design-Komponentenpalette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Abfrage: Abfragt Objektdaten von einem OData-Endpunkt und ist als Quelle in einem Vorgang vorgesehen.

• Aktualisierung: Aktualisiert Objektdaten in einem OData-Endpunkt und ist als Ziel in einem Vorgang vorgesehen.

• Einfügen: Fügt Objektdaten in einen OData-Endpunkt ein und ist als Ziel in einem Vorgang vorgesehen.

• Löschen: Löscht Objektdaten von einem OData-Endpunkt und ist als Ziel in einem Vorgang vorgesehen.