Zum Inhalt springen

HTTP v2-Connector in Jitterbit Studio

Zusammenfassung

Der HTTP v2-Connector stellt Zugriff über das HTTP- oder HTTPS-Protokoll auf einen Service wie eine REST-API, GraphQL-API oder ein Webformular bereit.

Der HTTP v2-Connector bietet eine Schnittstelle zum Erstellen einer HTTP v2-Verbindung, die Grundlage für die Generierung von Instanzen von HTTP v2-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration mit einem Service, auf den über das HTTP- oder HTTPS-Protokoll durch die Verbindung zugegriffen werden kann.

Der HTTP v2-Connector wird über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

Weitere Möglichkeiten zum Verbinden mit einem RESTful-Webservice und einen Vergleich mit dem HTTP-Connector finden Sie unter Überlegungen zu REST-basierten Connectors.

Wichtig

Mit der Veröffentlichung des HTTP v2-Connectors empfehlen wir, vorhandene HTTP-Verbindungen und -Aktivitäten zu HTTP v2 zu konvertieren. Weitere Informationen zu den Vorteilen des HTTP v2-Connectors finden Sie in unserem HTTP v2-Blogbeitrag oder in einem Vergleich der Funktionen des HTTP- und HTTP v2-Connectors.

Jitterbit beabsichtigt langfristig, den HTTP-Connector einzustellen, was gemäß der End-of-Life-Richtlinie von Jitterbit angekündigt wird. Derzeit gibt es keinen Zeitplan für die Einstellung und der HTTP-Connector wird weiterhin vollständig unterstützt. Wir empfehlen, vorhandene HTTP-Verbindungen und -Aktivitäten nach Möglichkeit zu HTTP v2 zu konvertieren.

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer HTTP v2-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) verwendet werden können.

Ob eine Aktivitätsinstanz als Quelle oder Ziel verwendet werden kann, hängt davon ab, ob der Webservice eine strukturierte Anfrage erfordert oder eine strukturierte Antwort zurückgibt. Jede Aktivitätsinstanz kann mit Request- und Response-Schemas konfiguriert werden, wobei entweder benutzerdefinierte Schemas oder im Connector enthaltene Standardschemas verwendet werden.

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

HTTP v2-Aktivitätstypen

  • PATCH: Wendet Teiländerungen auf eine vorhandene Ressource auf einem Service an, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

  • HEAD: Ruft die Statuszeile und den Header-Bereich einer Ressource auf einem Service ab, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

  • POST: Erstellt eine neue Ressource auf einem Service, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

  • GET: Ruft Informationen über eine Ressource auf einem Service ab, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

  • OPTIONS: Ruft Informationen über die Kommunikationsoptionen für eine Ressource auf einem Service ab, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

  • BULK: Sendet mehrere Anfragen an einen Service, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

  • DELETE: Löscht eine Ressource auf einem Service, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

  • PUT: Ersetzt eine vorhandene Ressource auf einem Service, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

Mit diesem Connector erstellte Endpoints sind in der Endpoint-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update organization policy aussetzen.

Der HTTP v2 Connector wird verwendet, um mit einem Service zu interagieren, auf den über das HTTP- oder HTTPS-Protokoll mit einer benutzerdefinierten REST-API, GraphQL-API oder Web-Form zugegriffen werden kann. Die Request- und Response-Schemas des HTTP v2 Connectors werden entweder aus benutzerdefinierten Schemas oder aus Standard-Schemas definiert, die im Connector enthalten sind.

Fehlerbehebung

Wenn Probleme mit dem HTTP v2 Connector auftreten, werden folgende Schritte zur Fehlerbehebung 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 Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update organization policy verwendet wird).

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

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

  4. Bei Verwendung von privaten Agenten können Sie das Verbose-Logging für Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten einfügen:

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

    Weitere Informationen zum Verbose-Logging für Connectors finden Sie unter Verbose-Logging für Connectors mit Jitterbit-Privatagenten.

  5. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.

  7. Informationen zu Problemen und Lösungen, die speziell für den HTTP v2 Connector gelten, finden Sie im Leitfaden Connector-Fehlerbehebung:

Praktische Beispiele