Zum Inhalt springen

HTTP v2 Connector für Jitterbit Studio

Zusammenfassung

Der HTTP v2 Connector ermöglicht den Zugriff über das HTTP- oder HTTPS-Protokoll auf einen Dienst wie eine REST-API, GraphQL-API oder ein Webformular.

Der HTTP v2 Connector bietet eine Schnittstelle zur Erstellung einer HTTP v2-Verbindung, die als Grundlage für die Generierung von Instanzen von HTTP v2-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit einem Dienst, der über das HTTP- oder HTTPS-Protokoll zugänglich ist.

Der HTTP v2 Connector wird über die Registerkarte Projektendpunkte und Connectoren in der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Für andere Möglichkeiten, sich mit einem RESTful-Webdienst zu verbinden, und einen Vergleich mit dem HTTP Connector siehe Überlegungen zu REST-basierten Connectoren.

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 von HTTP und HTTP v2 Connectors an.

Jitterbits langfristige Absicht ist es, den HTTP Connector abzulehnen, was gemäß Jitterbits End-of-Life-Richtlinie angekündigt wird. Derzeit gibt es keinen Zeitplan für die Abkündigung, und der HTTP Connector bleibt vollständig unterstützt. Wir empfehlen, dass Sie bestehende HTTP-Verbindungen und -Aktivitäten auf HTTP v2 umstellen, wenn möglich.

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine HTTP v2-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden können.

Ob eine Aktivitätsinstanz als Quelle oder Ziel verwendet werden kann, hängt davon ab, ob der Webdienst eine strukturierte Anfrage erfordert oder eine strukturierte Antwort zurückgibt. Jede Aktivitätsinstanz kann mit Anfrage- und Antwortschemata konfiguriert werden, entweder mit benutzerdefinierten Schemata, die vom Benutzer bereitgestellt werden, oder mit Standardschemata, die mit dem Connector geliefert werden.

Zusammen werden eine spezifische HTTP v2-Verbindung und ihre Aktivitäten als HTTP v2-Endpunkt bezeichnet:

HTTP v2 Aktivitätstypen

  • PATCH: Wendet partielle Änderungen an einer bestehenden Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst an und kann als Quelle oder Ziel in einer Operation verwendet werden.

  • HEAD: Ruft die Statuszeile und den Header-Bereich 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.

  • POST: Erstellt eine neue Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst und kann als Quelle oder Ziel in einer Operation verwendet werden.

  • GET: Ruft Informationen über eine Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst ab und kann als Quelle oder Ziel in einer Operation verwendet werden.

  • OPTIONS: Ruft Informationen über die Kommunikationsoptionen für eine Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst ab und kann als Quelle oder Ziel in einer Operation verwendet werden.

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

  • DELETE: Löscht eine Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst und kann als Quelle oder Ziel in einer Operation verwendet werden.

  • PUT: Ersetzt eine bestehende Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst und kann als Quelle oder Ziel in einer Operation verwendet werden.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpoint-Nutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der HTTP v2 Connector erfordert die Verwendung einer Agent-Version 10.1 oder höher. Diese Agent-Versionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Der HTTP v2 Connector wird verwendet, um mit einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst zu interagieren, wobei eine vom Benutzer angegebene REST-API, GraphQL-API oder ein Webformular verwendet wird. Die Anfrage- und Antwortschemata des HTTP v2 Connectors werden entweder aus benutzerdefinierten Schemata oder aus Standard-Schemata, die mit dem Connector geliefert werden, definiert.

Fehlersuche

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

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisation Richtlinie Auto Connector Update deaktivieren).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Betriebs geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie das ausführliche Logging für den Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

<logger name="org.jitterbit.connector.verbose.logging.http" level="DEBUG"/>

Für weitere Informationen zum detaillierten Protokollieren von Verbindungsstellen siehe Detailliertes Protokollieren für Verbindungsstellen mit Jitterbit-Privatagenten.

  1. Wenn Sie Privatagenten verwenden, können Sie die Agentenprotokolle für weitere Informationen überprüfen.

  2. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.