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 Instanzen von HTTP-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind und entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

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).

Eine 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ü der Komponenten im Projektbereich Tab Komponenten).
• Die Seite Globale Endpunkte (siehe Einen globalen Endpunkt bearbeiten in Globale Endpunkte).

HTTP-Verbindung konfigurieren

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 eindeutig 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 bestimmte 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. Schließen Sie keine Abfrageparameter oder Pfade ein, es sei denn, sie werden für alle zugehörigen Aktivitäten verwendet (Sie können während der Aktivitätskonfiguration eindeutige 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: Falls zutreffend, geben Sie einen Benutzernamen und ein Passwort ein, die den Zugriff auf den HTTP-Server ermöglichen. Sie können diese Felder für die anonyme Authentifizierung leer lassen, 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 Liste der Fehlercodes manuell in die 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 der Versuche an (empfohlen nicht mehr als 5 Mal), um eine Anfrage an den HTTP-Endpunkt erneut zu senden. Wenn die Anfrage nach der maximalen Anzahl an 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 an Wiederholungen ausgelöst.

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

  • Sicherheitsoption: Wählen Sie, falls zutreffend, Basis-HTTP-Authentifizierung verwenden, um sich mit dem Host über die Basis-HTTP-Authentifizierung ohne SSL-Verschlüsselung zu authentifizieren. Beachten Sie, dass das angegebene Passwort im 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 gegen 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 Überschriften 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 Auswirkungen, 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 Agenten-Proxy-Konfiguration, falls vorhanden. Wenn in der Agenten-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 Agenten-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 Agenten-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 Variablen-Icon 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 keinen Content-Type benötigt, 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 spezifische 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.

    Maskierung von Anforderungsheadern

    Sensible Anforderungsheader werden standardmäßig in den Laufzeitprotokollen maskiert. Um zusätzliche Anforderungsheader bei der Verwendung von privaten Agenten zu maskieren, fügen Sie diese dem [Masking] Abschnitt der Konfigurationsdatei des privaten Agenten hinzu.

• 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 einem Vorgang 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.