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.

Die langfristige Absicht von Jitterbit ist es, 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 zum Erstellen von Aktivitätsinstanzen verwendet, 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.

Hinweis

Dieser Connector ist ein auf dem Connector SDK basierender Connector, auf den sich Jitterbit bei der Kommunikation von Änderungen an mit dem Connector SDK erstellten Connectoren beziehen kann.

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

Voraussetzungen und unterstützte API-Versionen

Der HTTP v2 Connector erfordert die Verwendung einer Agent-Version 10.1 oder später. Diese Agent-Versionen laden automatisch die neueste Version des Connectors herunter, wenn erforderlich.

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

Bei Problemen mit dem HTTP v2 Connector 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 Automatische Connector-Aktualisierung deaktivieren 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-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

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

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

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectoren mit privaten Jitterbit-Agents.

  5. Bei Verwendung von privaten Agents 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