Erstellen einer HTTP-Quelle im Jitterbit Design Studio

Einführung

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

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

Erstellen einer HTTP-Quelle

Sie können wählen, ob Sie eine neue HTTP-Quelle eigenständig oder innerhalb einer bestehenden Operation erstellen möchten. Weitere Informationen dazu, wie Quellen innerhalb von Operationen funktionieren, finden Sie unter Erstellen einer Operation.

Erstellen einer neuen HTTP-Quelle als eigenständige Quelle

Innerhalb Ihres Projekts im 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 auf der linken Seite mit der rechten Maustaste auf Quellen und wählen Sie Neue Quelle; oder

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

Wählen Sie im Popup HTTP als Typ aus:

Ihre neue Quelle erscheint in einem eigenen Neue Quelle-Tab im rechten Bereich des Fensters.

Erstellen einer neuen HTTP-Quelle in einer bestehenden Operation

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

• Doppelklicken Sie auf das Quellsymbol; wählen Sie im Popup Neue Quelle erstellen; oder

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

Im Konfigurationsbildschirm, der erscheint, verwenden Sie das Dropdown Typ, um HTTP auszuwählen, wie oben gezeigt.

Verwenden einer vorhandenen HTTP-Quelle in einem bestehenden Vorgang

Um eine vorhandene HTTP-Quelle in einem bestehenden Vorgang mit einer Quelle zu verwenden, können Sie dies auf folgende Weise festlegen:

• Innerhalb des Vorgangs doppelklicken Sie auf das Quellsymbol und wählen im resultierenden Popup die gewünschte HTTP-Quelle aus der Liste; oder

• Innerhalb des Vorgangs klicken Sie mit der rechten Maustaste auf das Quellsymbol, wählen Vorhandene Quelle auswählen und wählen im resultierenden Popup die gewünschte HTTP-Quelle aus der Liste; oder

• Ziehen Sie die gewünschte HTTP-Quelle aus dem Baum auf der linken Seite und lassen Sie sie auf das vorhandene Quellsymbol des Vorgangs fallen.

Konfigurieren einer HTTP-Quelle

Nachdem Sie eine HTTP-Quelle erstellt haben, öffnet sich der Konfigurationsbildschirm in der Hauptansicht von Design Studio. Sie können jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie doppelt auf das Quellsymbol im Vorgang klicken oder indem Sie doppelt auf die Quelle im Baum auf der linken Seite klicken.

Grundkonfiguration

Der Konfigurationsbildschirm wird ähnlich wie in diesem Beispiel erscheinen:

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

• Typ: Verwenden Sie das Dropdown, um HTTP auszuwählen, falls dies nicht bereits angegeben ist.

• Verbindungsparameter: Geben Sie die Einzelheiten 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, wie z.B. http://www.example.com/ups.app/xml/ShipConfirm.

    • Um SSL-Verschlüsselung zu verwenden, verwenden Sie https:// anstelle von http:// in der URL, wie z.B. https://www.example.com/ups.app/xml/ShipConfirm.

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

  • Login: Falls zutreffend, geben Sie den Benutzernamen und das Passwort ein, die den Zugriff auf die URL ermöglichen. Lassen Sie diese Felder leer, wenn kein Benutzername oder Passwort erforderlich ist.

  • Passwort: Geben Sie ein Passwort ein, das mit dem Login verwendet wird, um auf die in dem URL-Feld angegebene URL zuzugreifen, falls erforderlich.

• Retry-Option aktivieren: Nur in den Versionen 10.22 und höher von Design Studio verfügbar, wenn eine Umgebung verwendet wird, die mit einer privaten Agentengruppe verbunden ist. Diese Einstellung wird verwendet, um eine Anfrage erneut zu versuchen, wenn ein HTTP-Endpunkt 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 haben. Bei früheren Agentenversionen wird die Konfiguration dieser Einstellung ohne Fehler ignoriert.

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

  • Maximale Wiederholungen: Geben Sie die maximale Anzahl von Wiederholungen ein (empfohlen nicht mehr als 5 Wiederholungen), die eine Anfrage an NetSuite erneut gesendet wird. 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 wird die Protokolldatei des privaten Agenten jitterbit.log jede Wiederholung protokollieren.

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

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

• HTTP-Verb: Verwenden Sie das Dropdown-Menü, um eines von GET, POST, PUT, DELETE oder CUSTOM auszuwählen, je nach den Anforderungen des Endpunkts. Bei einem POST wird eine leere Anfrage an die URL gesendet und die Antwort wird als Quelle verwendet.

• Verbindung testen: Durch Klicken auf die -Schaltfläche wird die HTTP-Quelle getestet; Jitterbit führt eine HTTP-HEAD-Anfrage durch und gibt einen Fehler zurück, wenn dies nicht erfolgreich ist. Beachten Sie, dass HEAD möglicherweise nicht vom HTTP-Server, auf den die URL verweist, erlaubt ist, auch wenn GET oder POST erlaubt sind.

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

Optionen

Zusätzliche Verbindungsparameter können durch Klicken auf Optionen am Ende des Abschnitts Verbindungsparameter angegeben werden:

• Sicherheitsoptionen: Um den Agenten zu veranlassen, ein Zertifikat zur Authentifizierung beim Host zu verwenden, wählen Sie ein entsprechendes Zertifikat aus dem Dropdown-Menü aus. (Die grüne Schaltfläche rechts vom Dropdown-Menü aktualisiert die Liste der von Harmony verfügbaren Zertifikate.)

  • Falls zutreffend, wählen Sie Basis-HTTP-Authentifizierung verwenden, um sich beim Host mit grundlegender HTTP-Authentifizierung ohne SSL-Verschlüsselung zu authentifizieren. Beachten Sie, dass bei Verwendung dieser Option das bereitgestellte Passwort im Klartext gesendet wird. (Es wird nicht empfohlen, es sei denn, es ist erforderlich.)

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

  Hinweis

  Diese Einstellung hat keine Wirkung, wenn eine HTTP-Quelle aus einem Skript unter Verwendung der ReadFile oder WriteFile Funktionen referenziert wird.

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

  • Deaktivieren: Die Proxy-Einstellungen sind für diese spezifische Quelle deaktiviert, wodurch die Agenten-Proxy-Konfiguration umgangen wird, falls eine vorhanden ist.

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

  • Benutzerdefiniert: Proxy-Einstellungen sind für diese spezifische Quelle aktiviert, wobei hier bereitgestellte benutzerdefinierte Informationen verwendet werden. Diese Option umgeht die Agent-Proxy-Konfiguration, falls eine vorhanden ist. Wenn Benutzerdefiniert ausgewählt ist, werden diese Felder verfügbar:

    

    Siehe Aktivieren des Proxys für private Agenten für Details zu diesen Feldern.

    Hinweis

    Die Felder Host, Benutzer, Passwort und NTLM-Domäne unterstützen Variablen, die im Syntax mit eckigen Klammern eingegeben werden, mit 10.66-Agenten und später.

Erweiterte Eigenschaften

Zusätzliche erweiterte Parameter können durch Klicken auf Erweiterte Eigenschaften am Ende des Abschnitts Optionen angegeben werden. Diese betreffen die HTTP-Header, die mit der Anfrage gesendet werden, sowie SSL-bezogene Parameter:

• Inhaltskodierung aktivieren: Wenn aktiviert, 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 aktiviert, wird der Header "Transfer-Encoding: chunked" gesendet. Verwenden Sie diese Option, wenn Sie große Datensätze übertragen. Diese Option ist standardmäßig deaktiviert.

• Expect: 100-continue senden: Wenn aktiviert, 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 kein chunked Transfer-Encoding verwenden möchten. Diese Option ist standardmäßig deaktiviert.

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

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

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

• SSL-Version: Nur anwendbar bei Verwendung von HTTPS, ermöglicht die Angabe einer bestimmten SSL-Version, wenn der HTTP-Server dies erfordert. Der Standardwert ist "Negotiate". Verfügbare Optionen sind:

  

Vorgegebene globale Quellvariablen, die eine HTTP-Übermittlung beeinflussen

Diese vorgegebenen globalen Quellvariablen beeinflussen HTTP-Quellen:

• jitterbit.source.http.max_redirs
• jitterbit.source.http.request.header._HeaderName_ (im Skripteditor als jitterbit.source.http.response.header.* angezeigt)
• 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 Details.