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, die die Grundlage für die Generierung von Instanzen von HTTP v2-Aktivitäten bildet. Nach der Konfiguration interagieren diese Aktivitäten mit einem Dienst, der über die Verbindung über das HTTP- oder HTTPS-Protokoll zugänglich ist.

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 HTTP-Konnektor, siehe Überlegungen zum REST-basierten Konnektor.

Wichtig

Mit der Veröffentlichung des HTTP v2-Connectors empfehlen wir, bestehende HTTP-Verbindungen und-Aktivitäten auf HTTP v2 umzustellen. Erfahren Sie mehr über die Vorteile des HTTP v2-Connectors 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-Konnektor einzustellen. Dies wird gemäß der End-of-Life-Richtlinie von Jitterbit angekündigt. Derzeit gibt es keinen Zeitplan für die Einstellung der Unterstützung, und der HTTP-Connector wird weiterhin vollständig unterstützt. Wir empfehlen Ihnen, vorhandene HTTP-Verbindungen und-Aktivitäten auf HTTP v2 umzustellen, wenn möglich.

Connector-Übersicht

Dieser Connector dient zur Konfiguration einer HTTP v2-Verbindung. 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 einer Operation) oder Ziele (zum Verbrauchen von Daten in einer 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. Dabei können entweder benutzerdefinierte Schemata oder im Connector enthaltene Standardschemata verwendet werden.

Zusammen werden eine bestimmte HTTP v2-Verbindung und ihre Aktivitäten 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 als Quelle oder Ziel in einer Operation verwendet werden.
POST: Erstellt eine neue Ressource auf einem Dienst, der über das HTTP- oder HTTPS-Protokoll zugänglich ist und als Quelle oder Ziel in einer Operation verwendet werden kann.
ERHALTEN: Ruft Informationen zu einer Ressource eines über das HTTP- oder HTTPS-Protokoll zugänglichen Dienstes ab und kann als Quelle oder Ziel in einer Operation verwendet werden.
OPTIONEN: Ruft Informationen zu den Kommunikationsoptionen einer Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst ab und kann als Quelle oder Ziel in einer 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 als Quelle oder Ziel in einer Operation 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 einer Operation verwendet werden.

Hinweis

Dieser Konnektor ist ein Konnektor-SDK-basierter Konnektor, auf den Jitterbit bei der Kommunikation von Änderungen an mit dem Connector SDK erstellten Konnektoren verweisen kann.

Voraussetzungen und unterstützte API Versionen

Der HTTP v2-Konnektor erfordert die Verwendung eines Agenten der Version 10.1 oder höher. Diese Agent-Versionen 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 mithilfe 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 des Benutzers oder aus im Konnektor enthaltenen Standardschemata definiert.

Fehlerbehebung

Bei Problemen mit dem HTTP v2-Connector empfehlen wir die folgenden Schritte zur Fehlerbehebung:

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 Protokollierung für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.
Bei Verwendung privater Agenten können Sie die ausführliche Protokollierung des Connectors aktivieren für diesen Connector unter Verwendung des folgenden Konfigurationseintrags für 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 im Betrieb.