OData Verbindung

Einführung

Eine OData Verbindung, die mit dem OData Konnektor erstellt wurde, stellt den Zugriff auf OData her Endpoints. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von OData-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Erstellen oder Bearbeiten einer OData-Verbindung

Eine neue OData-Verbindung wird mithilfe des OData Konnektors von einem dieser Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

Eine vorhandene OData-Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer OData Verbindung

Jedes Benutzeroberflächenelement des OData Verbindungskonfigurationsbildschirms wird unten beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede OData-Verbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:) Dieser Name wird auch zur Identifizierung des OData Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• OData Metadaten URL: Geben Sie den OData Endpoint ein $metadata URL.

• Authentifizierung: Wählen Sie die Authentifizierungsmethode, eine von Keine Authentifizierung, Basisauthentifizierung oder OAuth2:

  • Keine Authentifizierung: Der Zugriff auf den OData Endpoint erfolgt anonym und ohne Autorisierung.

  • Basisauthentifizierung: Erweitert zusätzliche Konfigurationsoptionen, in denen Sie einen Benutzernamen und ein Passwort für die Basisauthentifizierung angeben:

    

    • 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:

    

    • Berechtigungstypen: Wählen Sie Client-Anmeldeinformationen oder Passwortberechtigung als Berechtigungstyp für die OAuth-Authentifizierung. Client-Anmeldeinformationen ist standardmäßig ausgewählt, aber Benutzer können einen zusätzlichen Benutzernamen und ein Passwort angeben, wenn Passwortberechtigung ausgewählt ist.

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

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

    • Client Secret: Geben Sie das Client Secret ein.

    • Benutzername: Geben Sie einen gültigen Benutzernamen ein. Nur sichtbar, wenn der Berechtigungstyp auf Kennwortberechtigung eingestellt ist.

    • Passwort: Geben Sie ein gültiges Passwort ein. Nur sichtbar, wenn der Grant Type auf Passwort-Grant eingestellt ist.

    • Geltungsbereich: Geben Sie den Geltungsbereich ein.

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

    • Client-Authentifizierung: Wählen Sie die Methode aus, mit der die Client-Authentifizierung in der Anfrage gesendet wird. Die Authentifizierung kann als Als Basic Auth-Header senden oder Client-Anmeldeinformationen im Text senden 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 definiert sind (Absatz 14) sowie alle benutzerdefinierten Header, die für den Endpoint spezifisch sind. Klicken Sie auf das Symbol „Hinzufügen“ um der folgenden Tabelle eine Header hinzuzufügen und für jeden Anforderungsparameter ein Key-Value Paar einzugeben.

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

  Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol oder Symbol „Löschen“ .

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

  Notiz

  Benutzerdefinierte Header müssen im Endpoint konfiguriert werden, damit er sie als Teil dieser Anfrage akzeptiert. Wenn Sie Microsoft Azure zur Verwaltung Ihres OData Endpoint verwenden, lesen Sie die Microsoft-Dokumentation zu Benutzerdefinierten Headern in Auf Endpoints zugreifen, die eine Authentifizierung erfordern.

  Wichtig

  Felder in der Tabelle Erweiterte HTTP-Eigenschaften zeigen das Variablensymbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

• Test: Klicken Sie hier, 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 heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine OData-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verwenden von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Abfrage: Fragt Objektdaten von einem OData Endpoint ab und ist zur Verwendung als Quelle in einer Operation vorgesehen.

• Aktualisieren: Aktualisiert Objektdaten in einem OData Endpoint und ist zur Verwendung als Ziel in einer Operation vorgesehen.

• Einfügen: Fügt Objektdaten in einen OData Endpoint ein und ist zur Verwendung als Ziel in einer Operation vorgesehen.

• Löschen: Löscht Objektdaten aus einem OData Endpoint und ist zur Verwendung als Ziel in einer Operation vorgesehen.