HTTP-Verbindung

Einführung

Eine HTTP-Verbindung, die mit dem HTTP-Connector erstellt wurde, richtet über das HTTP- oder HTTPS-Protokoll den Zugriff auf einen Dienst wie eine REST- API, eine GraphQL API oder ein Webformular ein. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von HTTP-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einer Operation) oder als Ziele (zum Verbrauchen von Daten in einer Operation) verwendet werden können.

Erstellen oder Bearbeiten einer HTTP-Verbindung

Von einem dieser Standorte aus wird mithilfe des HTTP-Connectors eine neue HTTP-Verbindung erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

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

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer HTTP-Verbindung

Jedes Benutzeroberflächenelement des HTTP-Verbindungskonfigurationsbildschirms wird unten beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede HTTP-Verbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:). Dieser Name wird auch zur Identifizierung des HTTP- Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• Basis URL: Geben Sie eine gültige Basis URL für die Verbindung ein. Um die SSL- Verschlüsselung zu verwenden, verwenden Sie einfach https:// in der URL. Fügen Sie keine Abfrage 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 und allen während der Aktivitätskonfiguration angegebenen Pfaden zusammengesetzt.

• Benutzername und Passwort: Geben Sie ggf. 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: Wählen Sie über das Menü ein verfügbares Zertifikat zur Authentifizierung beim HTTP-Server aus. Sie können clientseitige SSL-Zertifikate über die Management Console verwalten unter Anpassungen > Client-Zertifikate.

• Wiederholen: Funktioniert nur bei Verwendung einer Umfeld, die einer privaten Agentengruppe zugeordnet ist. Diese Einstellung wird verwendet, um eine Anforderung zu wiederholen, wenn ein HTTP- Endpoint einen dieser Statuscodes zurückgibt: 500, 502, 503, oder 504.

  Diese Einstellung wird wirksam, 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 gilt: RecoverableStatusCode Einstellung und die Fehlercodeliste müssen manuell zur privaten Agentkonfigurationsdatei 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) ein, die gewartet werden soll, bevor eine Anforderung erneut an den HTTP- Endpoint gesendet wird.

  • Maximale Wiederholungsversuche: Geben Sie die maximale Anzahl von Wiederholungsversuchen ein (empfohlen nicht mehr als 5 Mal), um eine Anfrage an den HTTP- Endpoint zu senden. Wenn die Anfrage nach der maximalen Anzahl von Wiederholungsversuchen immer noch fehlschlägt, wird eine Ausnahme mit einer Fehlermeldung im Operation zurückgegeben. Darüber hinaus protokolliert der private Agent jeden Wiederholungsversuch im jitterbit.log Protokolldatei.

    Jeder Wiederholungsversuch wird als Teil desselben Operation behandelt, wobei nur ein einziger Datensatz im Operation erscheint. Alle Operation, die zum Ausführen nachlegende Vorgänge konfiguriert sind, werden basierend auf dem Endstatus des Operation nach wiederholten Versuchen bis zur maximalen Anzahl an Wiederholungsversuchen ausgelöst.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

  

  • Sicherheitsoption: Wählen Sie ggf. Einfache HTTP-Authentifizierung verwenden, um sich beim Host mit einfacher HTTP-Authentifizierung ohne SSL- Verschlüsselung zu authentifizieren. Beachten Sie, dass bei Verwendung dieser Option das angegebene Passwort im Klartext gesendet wird. (Sofern nicht erforderlich, wird dies nicht empfohlen.)

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

    • HTTP-Digest

    • HTTP Digest mit Authentifizierung mit einer IE-Variante

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

    Notiz

    Diese Einstellung wird nicht wirksam, wenn HTTP-Aktivitäten von einem Script aus mit dem ReadFile oder WriteFile Funktionen.

  • Proxy-Einstellungen: Wenn Sie einen benutzerdefinierten Proxy angeben möchten, wählen Sie aus dem Dropdown-Menü eine dieser Optionen aus:

    • Standard: Proxy-Einstellungen werden mithilfe der privaten Agent-Proxy-Konfiguration aktiviert, falls vorhanden. Wenn in der Agentenkonfiguration keine Proxy-Einstellungen angegeben sind, hat die Einstellung Standard dasselbe Ergebnis wie die Einstellung Deaktivieren.

    • Deaktivieren: Proxy-Einstellungen werden für diese bestimmte Verbindung deaktiviert, wodurch die private Agent-Proxy-Konfiguration umgangen wird, falls vorhanden.

    • Benutzerdefiniert: Proxy-Einstellungen werden für diese spezielle Verbindung mithilfe der hier bereitgestellten benutzerdefinierten Informationen aktiviert. Diese Option umgeht die private Agent-Proxy-Konfiguration, sofern vorhanden, und verwendet stattdessen benutzerdefinierte Proxy-Informationen. Wenn Benutzerdefiniert ausgewählt ist, stehen Ihnen zusätzliche Felder zur Konfiguration zur Verfügung. Einzelheiten zu diesen Feldern finden Sie unter Proxy für private Agenten aktivieren.

      Hinweis

      Zusätzliche Felder mit variablem Symbol Unterstützung von Variablen mit 10.66-Agenten und höher.

  • Erweiterte HTTP-Eigenschaften: Legen Sie ggf. diese erweiterten Optionen fest:

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

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

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

    • Send Expect 100-continue: Wenn ausgewählt, wird der Header Expect: 100-continue 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 keine Chunked-Transfer-Kodierung verwenden möchten.

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

    • HTTP-Kodierung Gzip akzeptieren: Diese standardmäßig ausgewählte Option teilt dem HTTP-Server mit, dass Harmony eine Gzip-komprimierte Antwort akzeptieren kann. Im Gegenzug befolgt Harmony den RFC 1952-Standard und dekomprimiert Gzip HTTP-Antworten automatisch. Wenn der Server Gzip nicht verwendet, erkennt Harmony, dass die Antwort nicht komprimiert ist, und verarbeitet sie wie gewohnt.

      Notiz

      Diese Einstellung hat nichts mit dem Gzip Connector zu tun.

    • Nur anwendbar bei Verwendung von HTTPS: Verwenden Sie das Dropdown-Menü, um eine bestimmte SSL-Version auszuwählen, wenn der HTTP-Server dies erfordert. Die Standardeinstellung ist Verhandeln.

    • Anforderungsheader (eine Zeile pro Header): Jeder in dieses Feld eingegebene Text wird als HTTP- Header gesendet. Geben Sie jeden Header in einer Zeile an, sofern der Header nicht gemäß dem HTTP-Standard umbrochen wird. Dieses Feld unterstützt auch die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen durch Ersetzen der Variablen in eckigen Klammern [ ]mit ihren Werten.

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

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine HTTP-Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

• ERHALTEN: Ruft Informationen zu einer Ressource eines Dienstes ab, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann in einem Operation als Quelle oder Ziel verwendet werden.

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

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

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

• Brauch: Führt eine angegebene HTTP-Methode für einen Dienst aus, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann in einer Operation als Quelle oder Ziel verwendet werden.