HTTP v2-Connector für Jitterbit Integration Studio

Zusammenfassung

Der HTTP v2-Konnektor stellt über das HTTP- oder HTTPS-Protokoll den Zugriff auf einen Dienst wie eine REST API, eine GraphQL API oder ein Webformular her.

Der HTTP v2-Connector bietet eine Schnittstelle zum Erstellen einer HTTP v2-Verbindung, der Grundlage zum Generieren von Instanzen von HTTP v2-Aktivitäten. Nach der Konfiguration interagieren diese Aktivitäten über die Verbindung mit einem Dienst, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann.

Der Zugriff auf den HTTP v2-Konnektor erfolgt über die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).

Weitere Möglichkeiten zur Verbindung mit einem RESTful-Webdienst und ein Vergleich mit dem HTTP-Konnektor, siehe Überlegungen zu REST-basierten Konnektoren.

Wichtig

Mit der Veröffentlichung des HTTP v2-Connectors empfehlen wir, bestehende HTTP-Verbindungen und-Aktivitäten auf HTTP v2 umzustellen. Weitere Informationen zu den Vorteilen des HTTP v2-Connectors finden Sie in unserem HTTP v2-Blogbeitrag oder sehen Sie sich einen Vergleich der Funktionen des HTTP- und HTTP v2-Connectors an.

Jitterbit beabsichtigt langfristig, den HTTP-Connector abzuschaffen. Dies wird gemäß Jitterbits End-of-Life-Richtlinie angekündigt. Derzeit gibt es keinen Zeitplan für die Abkündigung und der HTTP-Connector wird weiterhin vollständig unterstützt. Wir empfehlen Ihnen, vorhandene HTTP-Verbindungen und-Aktivitäten auf HTTP v2 umzuwandeln, wenn möglich.

Connector-Übersicht

Mit diesem Connector wird zunächst eine HTTP v2-Verbindung konfiguriert. Mit dieser Verbindung verknüpfte Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Operation) oder Ziele (zum Verwenden von Daten in einem Operation) verwendet werden können.

Ob eine Aktivitätsinstanz als Quelle oder Ziel verwendet werden kann, hängt davon ab, ob der Webdienst eine strukturierte Anforderung erfordert oder eine strukturierte Antwort zurückgibt. Jede Aktivitätsinstanz kann mit Anforderungs- und Antwortschemata konfiguriert werden, wobei entweder vom Benutzer bereitgestellte benutzerdefinierte Schemata oder im Connector enthaltene Standardschemata verwendet werden können.

Eine bestimmte HTTP v2-Verbindung und ihre Aktivitäten werden zusammen als HTTP v2- Endpoint bezeichnet:

HTTP v2-Aktivitätstypen

PATCH: Wendet teilweise Änderungen auf eine vorhandene Ressource eines über das HTTP- oder HTTPS-Protokoll zugänglichen Dienstes an und kann als Quelle oder Ziel in einer Operation verwendet werden.
KOPF: Ruft die Statuszeile und den Header Abschnitt einer Ressource eines über das HTTP- oder HTTPS-Protokoll zugänglichen Dienstes ab und kann in einer Operation als Quelle oder Ziel verwendet werden.
POST: Erstellt eine neue Ressource auf einem Dienst, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Operation verwendet werden.
ERHALTEN: Ruft Informationen zu einer Ressource eines Dienstes ab, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann in einem Operation als Quelle oder Ziel verwendet werden.
OPTIONEN: Ruft Informationen zu den Kommunikationsoptionen für eine Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst ab und kann als Quelle oder Ziel in einem Operation verwendet werden.
SCHÜTTGUT: Sendet mehrere Anfragen an einen über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst und kann als Quelle oder Ziel in einer Operation verwendet werden.
LÖSCHEN: Löscht eine Ressource auf einem Dienst, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann in einem Operation als Quelle oder Ziel verwendet werden.
SETZEN: Ersetzt eine vorhandene Ressource auf einem Dienst, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Operation verwendet werden.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectoren kommuniziert werden.

Voraussetzungen und unterstützte API Versionen

Der HTTP v2-Connector erfordert die Verwendung eines Agenten der Version 10.1 oder höher. Diese Agentversionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

Der HTTP v2-Konnektor wird verwendet, um mit einem Dienst zu interagieren, der über das HTTP- oder HTTPS-Protokoll unter Verwendung einer benutzerdefinierten REST- API, GraphQL API oder eines Webformulars zugänglich ist. Die Anforderungs- und Antwortschemata des HTTP v2-Konnektors werden entweder aus benutzerdefinierten Schemata oder aus im Konnektor enthaltenen Standardschemata definiert.

Fehlerbehebung

Wenn Sie Probleme mit dem HTTP v2-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

Klicken Sie in der Verbindungskonfiguration auf die Schaltfläche Test, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren)).
Überprüfen Sie die Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.
Aktivieren Sie die debuggen für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.
Wenn Sie private Agenten verwenden, können Sie Connector Verbose Logging aktivieren für diesen Connector unter Verwendung dieses spezifischen Konfigurationseintrags mit Loggername und -ebene:
```
<logger name="org.jitterbit.connector.verbose.logging.http" level="DEBUG"/>
```
Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.
Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Vorgängen.