HTTP-Verbindung

Einführung

Eine HTTP-Verbindung, die mit dem HTTP-Connector erstellt wurde, ermöglicht den Zugriff über das HTTP- oder HTTPS-Protokoll auf einen Dienst wie eine REST-API, GraphQL-API oder ein Webformular. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von HTTP-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind, um sie entweder als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder als Ziele (zum Konsumieren von Daten in einem Vorgang) zu verwenden.

Erstellen oder Bearbeiten einer HTTP-Verbindung

Eine neue HTTP-Verbindung wird mit dem HTTP-Connector von einem dieser Standorte erstellt:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

Ein bestehende HTTP-Verbindung kann von diesen Orten aus bearbeitet werden:

• Der Tab Projektendpunkte und -verbindungen in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Tab Komponenten im Projektbereich (siehe Aktionenmenü für Komponenten im Projektbereich Tab Komponenten).
• Die Seite Globale Endpunkte (siehe Einen globalen Endpunkt bearbeiten in Globale Endpunkte).

Konfigurieren einer HTTP-Verbindung

Jedes Benutzeroberflächenelement des Bildschirms zur Konfiguration der HTTP-Verbindung wird im Folgenden beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede HTTP-Verbindung einzigartig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den HTTP-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

• Basis-URL: Geben Sie eine gültige Basis-URL für die Verbindung ein. Um SSL-Verschlüsselung zu verwenden, verwenden Sie einfach https:// in der URL. Fügen Sie keine Abfrageparameter oder Pfade hinzu, es sei denn, sie werden für alle zugehörigen Aktivitäten verwendet (Sie können während der Aktivitätskonfiguration einzigartige Pfade und Parameter angeben.). Die endgültige URL wird aus der hier angegebenen Basis-URL sowie aus allen während der Aktivitätskonfiguration angegebenen Pfaden zusammengesetzt.

• Benutzername und Passwort: Geben Sie, falls zutreffend, einen Benutzernamen und ein Passwort ein, die den Zugriff auf den HTTP-Server ermöglichen. Diese Felder können für die anonyme Authentifizierung leer gelassen werden, wenn kein Benutzername oder Passwort erforderlich ist.

• Zertifikat: Verwenden Sie das Menü, um ein verfügbares Zertifikat auszuwählen, um sich beim HTTP-Server zu authentifizieren. Sie können clientseitige SSL-Zertifikate über die Management-Konsole unter Anpassungen > Client-Zertifikate verwalten.

• Wiederholen: Funktioniert nur, wenn eine Umgebung verwendet wird, die mit einer privaten Agentengruppe verbunden ist. Diese Einstellung wird verwendet, um eine Anfrage zu wiederholen, wenn ein HTTP-Endpunkt einen dieser Statuscodes zurückgibt: 500, 502, 503 oder 504.

  Diese Einstellung tritt in Kraft, wenn sie mit privaten Agenten der Version 10.22 oder höher verwendet wird.

  Hinweis

  Für private Agenten der Versionen 10.30 bis 10.33 müssen die Einstellung RecoverableStatusCode und die Fehlercode-Liste manuell zur Konfigurationsdatei des privaten Agenten hinzugefügt werden.

  Aktivieren Sie das Kontrollkästchen Wiederholen, um zusätzliche Konfigurationsoptionen zu erweitern.

  • Wiederholungsintervall (Sekunden): Geben Sie die Anzahl der Sekunden (maximal 5 Sekunden) an, die gewartet werden soll, bevor eine Anfrage an den HTTP-Endpunkt erneut gesendet wird.

  • Maximale Wiederholungen: Geben Sie die maximale Anzahl von Versuchen an (empfohlen nicht mehr als 5 Versuche), um eine Anfrage an den HTTP-Endpunkt erneut zu senden. Wenn die Anfrage nach der maximalen Anzahl von Wiederholungen weiterhin fehlschlägt, wird eine Ausnahme mit einer Fehlermeldung im Betriebsprotokoll zurückgegeben. Darüber hinaus protokolliert der private Agent jede Wiederholung in der Protokolldatei jitterbit.log.

    Jede Wiederholung wird als Teil des gleichen Betriebsablaufs behandelt, wobei nur ein einzelner Datensatz im Betriebsprotokoll erscheint. Alle Betriebsaktionen, die konfiguriert sind, um nachgelagerte Operationen auszuführen, werden basierend auf dem Endstatus der Operation nach dem Wiederholen bis zur maximalen Anzahl von Wiederholungen ausgelöst.

• Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern.

  • Sicherheitsoption: Falls zutreffend, wählen Sie Basis-HTTP-Authentifizierung verwenden, um sich mit dem Host über die grundlegende HTTP-Authentifizierung ohne SSL-Verschlüsselung zu authentifizieren. Beachten Sie, dass das angegebene Passwort in Klartext gesendet wird, wenn diese Option verwendet wird. (Es wird nicht empfohlen, es sei denn, es ist erforderlich.)

    Wenn diese Option nicht verwendet wird, verhandelt Harmony standardmäßig mit dem Endpunkt, um zu bestimmen, welche Authentifizierungsmethoden unterstützt werden, und verwendet die bereitgestellten Anmeldeinformationen für eines der Protokolle. Neben der HTTP-Basis unterstützt Harmony diese HTTP-Authentifizierungsoptionen:

    • HTTP-Digest

    • HTTP-Digest mit Authentifizierung im IE-Stil

  • Zeilen ignorieren: Wenn es Header und/oder Fußzeilen in den Quelldaten gibt, die ignoriert werden sollen, geben Sie die Anzahl der zu ignorierenden Zeilen in den Feldern Erste und Letzte ein.

    Hinweis

    Diese Einstellung hat keine Wirkung, wenn HTTP-Aktivitäten aus einem Skript unter Verwendung der ReadFile oder WriteFile Funktionen referenziert werden.

  • Proxy-Einstellungen: Wenn Sie einen benutzerdefinierten Proxy angeben möchten, verwenden Sie das Dropdown-Menü, um eine dieser Optionen auszuwählen:

    • Standard: Proxy-Einstellungen sind aktiviert und verwenden die private Agent-Proxy-Konfiguration, falls vorhanden. Wenn in der Agent-Konfiguration keine Proxy-Einstellungen angegeben sind, hat die Einstellung Standard das gleiche Ergebnis wie die Einstellung Deaktivieren.

    • Deaktivieren: Proxy-Einstellungen sind für diese spezifische Verbindung deaktiviert und umgehen die private Agent-Proxy-Konfiguration, falls vorhanden.

    • Benutzerdefiniert: Proxy-Einstellungen sind für diese spezifische Verbindung aktiviert und verwenden die hier bereitgestellten benutzerdefinierten Informationen. Diese Option umgeht die private Agent-Proxy-Konfiguration, falls vorhanden, und verwendet stattdessen benutzerdefinierte Proxy-Informationen. Wenn Benutzerdefiniert ausgewählt ist, werden zusätzliche Felder verfügbar, die Sie konfigurieren können. Weitere Informationen zu diesen Feldern finden Sie unter Aktivieren des Proxys für private Agenten.

      Hinweis

      Zusätzliche Felder mit einem Symbol unterstützen Variablen mit 10.66 Agenten und später.

  • Erweiterte HTTP-Eigenschaften: Falls zutreffend, setzen Sie diese erweiterten Optionen:

    • Content-Type: Geben Sie den Content-Type der Anforderungsstruktur ein, die von der jeweiligen API erwartet wird. Wenn die verwendete Methode keine strukturierten Daten akzeptiert oder die API nicht erfordert, dass der Content-Type angegeben wird, können Sie dieses Feld leer lassen. Beispiele für Content-Types sind text/plain, application/json, application/x-www-form-urlencoded usw.

    • Inhaltskodierung aktivieren: Wenn ausgewählt, wird der Accept-Encoding-Header mit der von Harmony unterstützten Kodierung gesendet. Derzeit wird Gzip unterstützt.

    • Chunked Transfer-Encoding aktivieren: Wenn ausgewählt, wird der Transfer-Encoding: chunked-Header gesendet. Verwenden Sie diese Option, wenn Sie große Datensätze übertragen.

    • Send Expect 100-continue: Wenn ausgewählt, wird der Expect: 100-continue-Header gesendet. Mit dieser Option werden keine Daten gesendet, bis der HTTP-Server die Header validiert hat. Verwenden Sie diese Option, wenn Sie große Datenmengen senden, aber kein chunked transfer encoding verwenden möchten.

    • Schwache Chiffren zulassen: Wählen Sie dieses Kontrollkästchen aus, um mit HTTP-Servern zu kommunizieren, die schwache Chiffren (DES/3DES und RC4) verwenden.

    • HTTP Accept Encoding Gzip: Standardmäßig ausgewählt, teilt diese Option dem HTTP-Server mit, dass Harmony eine Gzip-komprimierte Antwort akzeptieren kann. Im Gegenzug folgt Harmony dem RFC 1952-Standard und dekomprimiert Gzip-HTTP-Antworten automatisch. Wenn der Server Gzip nicht verwendet, erkennt Harmony, dass die Antwort nicht komprimiert ist, und behandelt sie wie gewohnt.

    • Nur anwendbar bei Verwendung von HTTPS: Verwenden Sie das Menü, um die Auswahl von Negotiate (Standard) auf eine bestimmte SSL- oder TLS-Version zu ändern, falls erforderlich, und wählen Sie aus SSLv3, TLSv1.0, TLSv1.1, TLSv1.2 oder TLSv1.X. Wählen Sie TLSv1.X, wenn TLS 1.3 erforderlich ist.

• Anforderungsheader (Eine Zeile pro Header): Jeder Text, der in dieses Feld eingegeben wird, wird als HTTP-Header gesendet. Geben Sie jeden Header in einer Zeile an, es sei denn, der Header ist gemäß dem HTTP-Standard umschlossen. Dieses Feld unterstützt auch die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen, indem Variablen in eckigen Klammern [ ] durch ihre Werte ersetzt werden.

• Test: Klicken Sie, um die Verbindung zu überprüfen, indem Sie eine HTTP-GET-Anforderung ohne Authentifizierung senden.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine HTTP-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

• GET: Ruft Informationen über eine Ressource auf einem Dienst ab, der über das HTTP- oder HTTPS-Protokoll zugänglich ist, und kann als Quelle oder Ziel in einem Vorgang verwendet werden.

• PUT: Ersetzt eine vorhandene Ressource auf einem Dienst, der über das HTTP- oder HTTPS-Protokoll zugänglich ist, 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 kann als Quelle oder Ziel in einer Operation verwendet werden.

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

• Custom: Führt eine angegebene HTTP-Methode auf einem Dienst aus, der über das HTTP- oder HTTPS-Protokoll zugänglich ist, und kann als Quelle oder Ziel in einer Operation verwendet werden.