Zum Inhalt springen

Erstellen einer HTTP-Quelle in Jitterbit Design Studio

Einführung

Eine HTTP-Verbindung kann in Jitterbit konfiguriert und als Quelle verwendet werden.

Wenn eine HTTP-Verbindung als Quelle verwendet wird, übermittelt der Jitterbit-Agent eine HTTP-Aktion (eine von GET, POST, PUT, DELETE oder CUSTOM) und ruft Daten von der in der Quellkonfiguration angegebenen URL ab.

Erstellen einer HTTP-Quelle

Sie können eine neue HTTP-Quelle eigenständig oder innerhalb einer vorhandenen Operation erstellen. Weitere Informationen zur Funktionsweise von Quellen innerhalb von Operationen finden Sie unter Erstellen einer Operation.

Erstellen Sie eine neue HTTP-Quelle als eigenständige Quelle

In Ihrem Projekt in Jitterbit Design Studio erstellen Sie eine neue HTTP-Quelle auf eine der folgenden Arten:

  • Gehen Sie zu Datei > Neu > Neue Quelle; oder

  • Klicken Sie im Baum links mit der rechten Maustaste auf Quellen und wählen Sie Neue Quelle; oder

  • Klicken Sie in der oberen Symbolleiste auf das grüne Quellensymbol Quellensymbol.

Wählen Sie im Popup HTTP als Typ aus:

HTTP-Typ

Ihre neue Quelle wird im rechten Fensterbereich auf einer eigenen Tab Neue Quelle angezeigt.

Notiz

Wenn Sie mit einer dieser Methoden eine eigenständige Quelle erstellen, beachten Sie, dass diese nicht mit einer Operation verbunden ist. Siehe Eine vorhandene HTTP-Quelle in einer vorhandenen Operation verwenden unten, um die neue Quelle zu verwenden.

Erstellen einer neuen HTTP-Quelle in einem vorhandenen Operation

Eine Quelle wird normalerweise standardmäßig erstellt, wenn Sie eine neue Operation erstellen. (Die Ausnahme ist eine Operation, die nur aus einem Script besteht.) Bei einer vorhandenen Operation können Sie den Typ ihrer Quelle wie folgt angeben:

  • Doppelklicken Sie auf das Quellensymbol. Wählen Sie im Popup Neue Quelle erstellen aus. oder

  • Klicken Sie mit der rechten Maustaste auf das Quellensymbol und wählen Sie Neue Quelle erstellen.

Wählen Sie im angezeigten Konfigurationsbildschirm im Dropdown-Menü Typ HTTP aus, wie oben gezeigt.

Verwenden einer vorhandenen HTTP-Quelle in einem vorhandenen Operation

Um eine vorhandene HTTP-Quelle in einem vorhandenen Operation mit einer Quelle zu verwenden, können Sie sie wie folgt festlegen:

  • Doppelklicken Sie innerhalb des Operation auf das Quellsymbol und wählen Sie im angezeigten Popup die gewünschte HTTP-Quelle aus der Liste aus. oder

  • Klicken Sie während des Operation mit der rechten Maustaste auf das Quellsymbol, wählen Sie Vorhandene Quelle auswählen und wählen Sie im daraufhin angezeigten Popup die gewünschte HTTP-Quelle aus der Liste aus. oder

  • Ziehen Sie die gewünschte HTTP-Quelle aus dem Baum links und legen Sie sie auf dem vorhandenen Quellensymbol der Operation ab.

Konfigurieren einer HTTP-Quelle

Nachdem Sie eine HTTP-Quelle erstellt haben, wird der Konfigurationsbildschirm in der Hauptansicht von Design Studio geöffnet. Sie können jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie in der Operation auf das Quellensymbol doppelklicken oder im Baum links auf die Quelle doppelklicken.

Grundkonfiguration

Der Konfigurationsbildschirm sieht ähnlich wie dieses Beispiel aus:

HTTP-Quellkonfiguration

  • Name: Geben Sie einen passenden, eindeutigen Namen für die Quelle ein.

  • Typ: Verwenden Sie die Dropdown-Liste, um HTTP auszuwählen, falls es nicht bereits angegeben ist.

  • Verbindungsparameter: Geben Sie die Details für Ihre HTTP-Verbindung an:

    • URL: Geben Sie eine gültige URL für die Quelle ein. Eine HTTP-Quelle wird durch die URL der Ressource definiert, z. B. http://www.example.com/ups.app/xml/ShipConfirm.

      • Um die SSL- Verschlüsselung zu verwenden, verwenden Sie https:// anstatt http:// in der URL, wie etwa https://www.example.com/ups.app/xml/ShipConfirm.

      • Wenn Abfrage angegeben werden, geben Sie diese so ein, wie sie in einem Webbrowser angegeben werden würden, z. B. https://www.example.com/queryrecord?id=10.

    • Anmeldung: Geben Sie ggf. den Benutzernamen und das Kennwort ein, die den Zugriff auf die URL ermöglichen. Lassen Sie diese Felder leer, wenn kein Benutzername oder Kennwort erforderlich ist.

    • Passwort: Geben Sie bei Bedarf ein Passwort ein, das zusammen mit dem Login verwendet werden soll, um auf die im Feld URL referenzierte URL zuzugreifen.

  • Option „Wiederholung aktivieren“: Diese Einstellung ist nur in Design Studio Versionen 10.22 und höher verfügbar, wenn eine Umfeld verwendet wird, die einer privaten Agentengruppe zugeordnet ist. Sie wird verwendet, um eine Anforderung zu wiederholen, wenn ein HTTP- Endpoint einen dieser Statuscodes zurückgibt: 500, 501, 502, 503, oder 504.

    Damit diese Einstellung wirksam wird, müssen private Agenten die Version 10.22 oder höher aufweisen. Bei früheren Agentenversionen wird die Konfiguration dieser Einstellung ohne Fehler ignoriert.

    Aktivieren Sie das Kontrollkästchen, um zusätzliche Konfigurationsoptionen zu aktivieren:

    • Maximale Wiederholung: Geben Sie die maximale Anzahl von Wiederholungsversuchen ein (empfohlen nicht mehr als 5 Wiederholungsversuche), bei denen eine Anfrage erneut an NetSuite gesendet wird. 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 wird die private Agenten-Protokolldatei jitterbit.log protokolliert jeden Wiederholungsversuch.

      Jeder Wiederholungsversuch wird als Teil desselben Operation behandelt, wobei nur ein einziger Datensatz im Operation erscheint. Alle zum Ausführen nachlegende Vorgänge konfigurierten Ereignisse „Bei Erfolg“ oder „Bei Fehler“ werden basierend auf dem Endstatus des Operation nach der maximalen Anzahl von Wiederholungsversuchen ausgelöst.

    • Wiederholungsintervall (Sekunden): Geben Sie die Anzahl der Sekunden (maximal 5) ein, die zwischen dem erneuten Senden einer Anforderung an den HTTP- Endpoint gewartet werden soll.

  • HTTP-Verb: Wählen Sie aus dem Dropdown-Menü je nach den Anforderungen des Endpoint eine der Optionen GET, POST, PUT, DELETE oder CUSTOM aus. Bei einem POST wird eine leere Anfrage an die URL gesendet und die Antwort als Quelle verwendet.

  • Verbindung testen: Klicken Sie auf die Schaltfläche Verbindung testen-Schaltfläche testet die HTTP-Quelle; Jitterbit führt eine HTTP-HEAD-Anforderung aus und gibt einen Fehler zurück, wenn diese nicht erfolgreich ist. Beachten Sie, dass HEAD vom HTTP-Server, auf den die URL verweist, möglicherweise nicht zugelassen wird, selbst wenn GET oder POST zugelassen sind.

  • Klicken Sie in der Hauptsymbolleiste oder in der Zielsymbolleiste auf die Schaltfläche Speichern, um die Konfiguration zu speichern.

Optionen

Weitere Verbindungsparameter können durch Klicken auf Optionen unten im Abschnitt Verbindungsparameter angegeben werden:

HTTP-Verbindungsparameter

  • Sicherheitsoptionen: Damit der Agent ein Zertifikat zur Authentifizierung beim Host verwendet, geben Sie ein entsprechendes Zertifikat aus dem Dropdown-Menü an. (Die grüne Schaltfläche rechts neben dem Dropdown-Menü aktualisiert die Liste der von Harmony verfügbaren Zertifikate.)

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

  • Zeilen ignorieren: Die angegebene Anzahl der ersten und letzten Zeilen, die für jede Datei ignoriert werden sollen. Wenn Kopf- oder Fußzeilen ignoriert werden sollen, geben Sie die Anzahl der Zeilen entsprechend in die Felder Erste und Letzte ein.

    Notiz

    Diese Einstellung wird nicht wirksam, wenn eine HTTP-Quelle von einem Script mit dem ReadFile oder WriteFile Funktionen.

  • Proxy-Einstellungen: Verwenden Sie das Dropdown-Menü, um eine dieser Optionen für einen benutzerdefinierten Proxy für den HTTP- Host auszuwählen:

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

    • Standard: Proxy-Einstellungen werden mithilfe der 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.

    • Benutzerdefiniert: Proxy-Einstellungen werden für diese bestimmte Quelle mithilfe der hier bereitgestellten benutzerdefinierten Informationen aktiviert. Diese Option umgeht die Agenten-Proxy-Konfiguration, falls eines vorhanden ist. Wenn Benutzerdefiniert ausgewählt ist, werden diese Felder verfügbar:

      Benutzerdefinierte zusätzliche Felder

      Siehe Proxy für private Agenten aktivieren für Einzelheiten zu diesen Feldern.

      Hinweis

      Die Felder Host, Benutzer, Passwort und NTLM-Domäne unterstützen Variablen, die in eckigen Klammern eingegeben werden, mit Agenten der Version 10.66 und höher.

Erweiterte Eigenschaften

Weitere erweiterte Parameter können durch Klicken auf Erweiterte Eigenschaften unten im Abschnitt Optionen angegeben werden. Diese betreffen die mit der Anfrage gesendeten HTTP-Header und SSL-bezogenen Parameter:

Erweiterte HTTP-Eigenschaften

  • Inhaltskodierung aktivieren: Wenn diese Option aktiviert ist, wird der Header „Accept-Encoding“ mit der von Jitterbit unterstützten Kodierung gesendet. Derzeit wird Gzip unterstützt. Diese Option ist standardmäßig deaktiviert.

  • Chunked-Transfer-Encoding aktivieren: Wenn diese Option aktiviert ist, wird der Header „Transfer-Encoding: chunked“ gesendet. Verwenden Sie diese Option, wenn Sie große Datensätze übertragen. Diese Option ist standardmäßig deaktiviert.

  • Send Expect: 100-continue: Wenn diese Option aktiviert ist, 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. Diese Option ist standardmäßig deaktiviert.

  • Schwache Chiffren zulassen: Wenn diese Option aktiviert ist, wird die Kommunikation mit HTTP- Endpoints zugelassen, die schwache Chiffren verwenden (DES/3DES und RC4). Diese Option ist standardmäßig deaktiviert.

  • Accept-Encoding auf GZip setzen: Diese Option ist standardmäßig aktiviert und teilt dem HTTP-Server mit, dass Jitterbit eine Gzip-komprimierte Antwort akzeptieren kann. Im Gegenzug folgt Jitterbit dem RFC 1952-Standard und dekomprimiert Gzip HTTP-Antworten automatisch. Wenn der Server Gzip nicht verwendet, erkennt Jitterbit, dass die Antwort nicht komprimiert ist, und verarbeitet sie wie gewohnt. Diese Funktion wurde ab Jitterbit Version 8.20 hinzugefügt und ist jetzt standardmäßig für alle neuen und vorhandenen HTTP-Quellen aktiviert.

  • Anforderungsheader (eine Zeile pro Header): Jeder in dieses Feld eingegebene Text wird als HTTP- Header gesendet. Geben Sie einen Header pro Zeile an, sofern der Header nicht gemäß dem HTTP-Standard umbrochen wird. Globale Datenelemente in eckigen Klammern werden durch ihre Werte ersetzt.

  • SSL-Version: Gilt nur bei Verwendung von HTTPS. Ermöglicht die Angabe einer bestimmten SSL-Version, wenn der HTTP-Server dies erfordert. Die Standardeinstellung ist „Verhandeln“. Verfügbare Optionen sind:

    HTTP SSL-Versionsoptionen

Vordefinierte globale Quellvariablen, die sich auf eine HTTP-Übermittlung auswirken

Diese vordefinierten globalen Quellvariablen betreffen HTTP-Quellen:

  • jitterbit.source.http.max_redirs- jitterbit.source.http.request.header._HeaderName_ (im Script angezeigt als jitterbit.source.http.response.header.*)
  • jitterbit.source.http.response- jitterbit.source.http.ssl_cert_id- jitterbit.source.http.status_code- jitterbit.source.http.transfer_timeout

Siehe Quell-Jitterbit-Variablen für Einzelheiten.