Erstellen eines HTTP-Ziels im Jitterbit Design Studio

Einführung

HTTP-Ziele werden typischerweise als Endpunkt einer Transformationsoperation verwendet.

Wenn HTTP als Ziel verwendet wird, sendet der Jitterbit-Agent eine HTTP-Aktion (eine der Methoden GET, POST, PUT, DELETE oder CUSTOM) und übergibt Daten an die in der Zielkonfiguration angegebene URL.

Sie können ein HTTP-Ziel mit Headerinformationen für eine POST-Aktion in der Definition konfigurieren. Wenn es in einer Operation verwendet wird, wird eine ASCII-Textnachricht gebildet, indem diese Headerinformationen, eine Leerzeile und die transformierten Informationen aus einer Quelle verwendet werden.

Betrachten Sie beispielsweise eine Transformation einer Abfrage aus einer Quelldatenbank in ein XML-Dokument. Die Daten werden aus der Quelle abgerufen und dann in das XML-Dokumentformat transformiert, wie es in der Transformation definiert ist. Anschließend werden die Ziel-Headerinformationen (definiert durch die Zieldefinition) an den Anfang des XML-Dokuments hinzugefügt, zusammen mit einer Leerzeile, und dann der XML-Inhalt. Das endgültige Dokument wird dann mit einem HTTP-POST-Befehl an die Ziel-URL übergeben.

Ähnlich wie bei einer HTTP-Quelle wird eine Antwort von der HTTP-Anfrage zurückgegeben und dann analysiert. Wenn die Nachricht Erfolg anzeigt, wird nichts weiter unternommen. Wenn eine Fehlermeldung empfangen wird, wird sie als Teil des Fehlerprotokollierungsprozesses für die Operation verwendet.

Erstellen eines HTTP-Ziels

Sie können wählen, ob Sie ein neues HTTP-Ziel eigenständig oder innerhalb einer bestehenden Operation erstellen möchten. Für Details, wie Ziele innerhalb von Operationen funktionieren, siehe Erstellen einer Operation.

Erstellen eines neuen HTTP-Ziels als eigenständiges Ziel

Innerhalb Ihres Projekts im Jitterbit Design Studio erstellen Sie ein neues HTTP-Ziel auf eine der folgenden Arten:

• Gehen Sie zu Datei > Neu > Neues Ziel; oder

• Klicken Sie im Baum auf der linken Seite mit der rechten Maustaste auf Ziele und wählen Sie Neues Ziel; oder

• Klicken Sie in der oberen Symbolleiste auf das blaue Zielsymbol .

Wählen Sie im Popup HTTP als Typ aus:

Ihr neues Ziel erscheint in einem eigenen Neues Ziel-Tab im rechten Bereich des Fensters.

Erstellen Sie ein neues HTTP-Ziel in einer vorhandenen Operation

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

• Doppelklicken Sie auf das Zielsymbol; wählen Sie im Popup Neues Ziel erstellen; oder

• Klicken Sie mit der rechten Maustaste auf das Zielsymbol und wählen Sie Neues Ziel erstellen.

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

Verwenden Sie ein vorhandenes HTTP-Ziel in einer vorhandenen Operation

Um ein vorhandenes HTTP-Ziel in einer vorhandenen Operation mit einem Ziel zu verwenden, können Sie es auf eine der folgenden Arten festlegen:

• Innerhalb der Operation doppelklicken Sie auf das Zielsymbol und wählen im resultierenden Popup das gewünschte HTTP-Ziel aus der Liste aus; oder

• Innerhalb der Operation klicken Sie mit der rechten Maustaste auf das Zielsymbol, wählen Vorhandenes Ziel auswählen und wählen im resultierenden Popup das gewünschte HTTP-Ziel aus der Liste aus; oder

• Ziehen Sie das gewünschte HTTP-Ziel aus dem Baum auf der linken Seite und lassen Sie es auf das vorhandene Zielsymbol der Operation fallen.

Konfigurieren eines HTTP-Ziels

Nachdem Sie ein HTTP-Ziel erstellt haben, wird der Konfigurationsbildschirm in der Hauptansicht von Design Studio geöffnet. Sie können jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie doppelt auf das Zielsymbol in der Operation klicken oder indem Sie doppelt auf das Ziel im Baum auf der linken Seite klicken.

Grundkonfiguration

Der Konfigurationsbildschirm wird ähnlich wie in diesem Beispiel angezeigt:

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

• Typ: Verwenden Sie das Dropdown-Menü, 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 das Ziel ein. Ein HTTP-Ziel 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.

  • Anmeldung: Geben Sie, falls zutreffend, 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 der Anmeldung verwendet wird, um auf die in dem URL-Feld angegebene URL zuzugreifen, falls erforderlich.

  • Option zum Wiederholen aktivieren: Diese Einstellung ist nur in den Design Studio-Versionen 10.22 und höher verfügbar, wenn Sie eine Umgebung verwenden, 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, 501, 502, 503 oder 504.

    Damit diese Einstellung wirksam wird, müssen private Agenten Version 10.22 oder höher sein. 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 an Wiederholungen ein (empfohlen sind nicht mehr als 5 Wiederholungen), die eine Anfrage an NetSuite erneut gesendet wird. 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 wird die private Agent-Protokolldatei 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 an Wiederholungen ausgelöst.

    • Wiederholungsintervall (Sekunden): Geben Sie die Anzahl der Sekunden (maximal 5) an, 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 wird das HTTP-Ziel 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 Speichern-Schaltfläche in der Hauptsymbolleiste oder in der Symbolleiste des Ziels, um die Konfiguration zu speichern.

Optionen

Zusätzliche Verbindungsparameter können angegeben werden, indem Sie auf Optionen am Ende des Abschnitts Verbindungsparameter klicken:

• Content-Type: Der Standard-Content-Type ist leer, was verwendet werden sollte, wenn die verwendete Methode keine strukturierten Daten akzeptiert oder wenn die API nicht erfordert, dass der Content-Type angegeben wird. Dies kann geändert werden, indem Standard-Content-Type verwenden deaktiviert und ein geeigneter Content-Type angegeben wird. Beispiele für Content-Types sind text/plain, application/json, application/x-www-form-urlencoded usw.

• 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. (Der grüne Button rechts vom Dropdown-Menü aktualisiert die Liste der verfügbaren Zertifikate von Harmony.)

  Wenn zutreffend, wählen Sie Basis-HTTP-Authentifizierung verwenden, um sich beim Host ohne SSL-Verschlüsselung mit der Basis-HTTP-Authentifizierung zu authentifizieren. Beachten Sie, dass das angegebene Passwort in Klartext gesendet wird. (Es wird nicht empfohlen, es sei denn, es ist erforderlich.)

  Tipp

  Sie können clientseitige SSL-Zertifikate über die Management-Konsole unter Anpassungen > Client-Zertifikate verwalten.

• Antwort speichern in (optional): Um die Antwort vom HTTP-Server zu speichern, geben Sie an, dass sie in ein separates Ziel geschrieben werden soll, indem Sie das Dropdown-Menü verwenden. Wenn angegeben, wird die Schaltfläche Bearbeiten aktiviert, um die Bearbeitung dieses Ziels zu ermöglichen.

• 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: Die Proxy-Einstellungen sind für dieses spezifische Ziel aktiviert, wobei hier benutzerdefinierte Informationen bereitgestellt werden. Diese Option umgeht die Agenten-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, User, Password und NTLM Domain unterstützen Variablen, die im Syntax mit eckigen Klammern eingegeben werden, ab 10.66 Agenten.

Erweiterte Eigenschaften

Zusätzliche erweiterte Parameter können durch Klicken auf die Erweiterten 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 verlangt. Der Standardwert ist "Negotiate". Verfügbare Optionen sind:

  

Vorgegebene globale Zielvariablen, die ein HTTP-Ziel beeinflussen

Diese vorgegebenen globalen Zielvariablen beeinflussen HTTP-Ziele:

• jitterbit.target.http.form_data
• jitterbit.target.http.form_data.ContentType
• jitterbit.target.http.form_data.filename
• jitterbit.target.http.form_data.name
• jitterbit.target.http.max_redirs
• jitterbit.target.http.remove_trailing_linebreaks
• jitterbit.target.http.request.header._HeaderName_ (im Skripteditor als jitterbit.target.http.response.header.* angezeigt)
• jitterbit.target.http.ssl_cert_id
• jitterbit.target.http.status_code
• jitterbit.target.http.transfer_timeout

Siehe Ziel-Jitterbit-Variablen für Details.