Zum Inhalt springen

HTTP POST-Aktivität

Einführung

Eine HTTP POST-Aktivität, die ihre HTTP-Verbindung verwendet, ersetzt eine vorhandene Ressource auf einem über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst und kann entweder als Quelle (um Daten in einer Operation bereitzustellen) oder als Ziel (um Daten in einer Operation zu konsumieren) verwendet werden.

Wichtig

Mit der Veröffentlichung des HTTP v2-Connectors empfehlen wir, bestehende HTTP-Verbindungen und -Aktivitäten auf HTTP v2 zu konvertieren. Erfahren Sie mehr über die Vorteile des HTTP v2-Connectors in unserem HTTP v2-Blogbeitrag oder sehen Sie sich einen Vergleich der Funktionen von HTTP- und HTTP v2-Connectors an.

Jitterbits langfristige Absicht ist es, den HTTP-Connector abzulehnen, was gemäß Jitterbits End-of-Life-Richtlinie angekündigt wird. Derzeit gibt es keinen Zeitplan für die Abkündigung, und der HTTP-Connector bleibt vollständig unterstützt. Wir empfehlen, dass Sie bestehende HTTP-Verbindungen und -Aktivitäten auf HTTP v2 konvertieren, wenn möglich.

Erstellen einer HTTP POST-Aktivität

Eine Instanz einer HTTP POST-Aktivität wird aus einer HTTP-Verbindung unter Verwendung ihres POST-Aktivitätstyps erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene HTTP POST-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer HTTP Post-Aktivität

Befolgen Sie diese Schritte, um eine HTTP POST-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen

In diesem Schritt geben Sie einen Namen für die Aktivität ein und spezifizieren die URL, die Anforderungsparameter und die Anforderungsheader. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

Wichtig

Felder in den Tabellen zeigen das Variablen-Icon nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

  • Endpunktmenü: Wenn Sie mehrere Endpunkte desselben Verbindungstyps konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Erscheint, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede HTTP POST-Aktivität einzigartig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • HTTP-Verb: Das HTTP-Verb kann nicht geändert werden.

    Hinweis

    Für ein als Quelle verwendetes HTTP POST wird eine leere Anfrage an die URL gesendet, und die Antwort wird als Quelle verwendet.

    Für ein als Ziel verwendetes HTTP POST kann praktisch jede Art von Payload enthalten sein, muss jedoch vom Webserver, der sie empfängt, verstanden werden. Eine Antwort wird basierend auf der HTTP-Anfrage zurückgegeben und von Harmony analysiert. Wenn die Antwort Erfolg anzeigt, wird nichts weiter unternommen. Wenn eine Fehlermeldung empfangen wird, wird sie als Teil des Fehlerprotokollierungsprozesses für die Operation verwendet und in den Betriebsprotokollen gemeldet.

  • Pfad: Geben Sie einen Pfad und/oder Abfrageparameter ein, die an die Basis-URL angehängt werden sollen, die in der Konfiguration der HTTP-Verbindung angegeben wurde. Wenn Sie Abfrageparameter angeben, geben Sie diese so an, wie Sie es in einem Webbrowser tun würden, z. B. /queryrecord?id=10.

  • URL: Die URL, die als Verkettung der Basis-URL und des oben eingegebenen Pfads erstellt wurde, wird zur Referenz bereitgestellt. Um die URL zu bearbeiten, ändern Sie entweder die Basis-URL in der HTTP-Verbindung oder den oben eingegebenen Pfad.

  • Anforderungsparameter: Klicken Sie auf die Schaltfläche Hinzufügen, um eine Zeile hinzuzufügen, und geben Sie dann einen spezifischen Namen und Wert für die angeforderten Parameter ein. Klicken Sie auf die Schaltfläche Entfernen, um eine vorhandene Zeile zu entfernen. Die bereitgestellten Anforderungsparameter werden automatisch URL-codiert.

  • Anforderungsheader: Klicken Sie auf die Schaltfläche Hinzufügen, um eine Zeile hinzuzufügen, und geben Sie dann einen spezifischen Namen und Wert für die angeforderten Headerinformationen ein. Klicken Sie auf die Schaltfläche Entfernen, um eine vorhandene Zeile zu entfernen.

    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.

  • Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

Schritt 2: Bereitstellung des Anforderungsschemas

In diesem Schritt können Sie ein benutzerdefiniertes Anforderungsschema bereitstellen (optional).

  • Anforderungsschema bereitstellen: Das Anforderungsschema definiert die Struktur der Anforderungsdaten, die von der HTTP-Aktivität verwendet werden. Ob ein Anforderungsschema erforderlich ist, hängt davon ab, ob die Aktivität als Ziel einer Transformation verwendet wird und ob der Webdienst strukturierte Anforderungsdaten erwartet (siehe Schema-Nutzung). Für Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration verweisen Sie auf In einer Aktivität definierte Schemata.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

Schritt 3: Bereitstellung des Antwortschemas

In diesem Schritt können Sie ein benutzerdefiniertes Antwortschema bereitstellen (optional).

  • Antwortschema bereitstellen: Das Antwortschema definiert die Struktur der Antwortdaten, die von der HTTP-Aktivität verwendet werden. Ob ein Antwortschema erforderlich ist, hängt davon ab, ob die Aktivität als Quelle einer Transformation verwendet wird und ob der Webdienst strukturierte Antwortdaten zurückgibt (siehe Schema-Nutzung). Für Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration siehe In einer Aktivität definierte Schemata.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 4: Überprüfen der Datenschemata

Die konfigurierten Anfrage- und Antwortschemata (sofern bereitgestellt) werden angezeigt.

  • Datenschema: Wenn während der Aktivitätskonfiguration bereitgestellt, werden die Anfrage- und/oder Antwortdatenschemata angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während des Transformations-Mappings Prozesses erneut angezeigt, wo Sie auf Zielfelder mit Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr abbilden können. Sie können auch Schemata direkt in einer Transformation definieren.

  • Plugin(s) hinzufügen: Plugins sind von Jitterbit oder Benutzern bereitgestellte Anwendungen, die die nativen Fähigkeiten von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und wählen Sie das Kontrollkästchen neben dem zu verwendenden Plugin aus. Für zusätzliche Anweisungen zur Verwendung von Plugins, einschließlich Details zur Festlegung aller erforderlichen Variablen, die vom Plugin verwendet werden, siehe Plugins, die zu einer Aktivität hinzugefügt wurden.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Jitterbit-Variablen, die die HTTP-Übermittlung beeinflussen

Das Harmony-System definiert bestimmte globale Variablen, die im gesamten Projekt immer verfügbar sind, bekannt als Jitterbit-Variablen oder als vordefinierte globale Variablen. Die unten aufgeführten Jitterbit-Variablen sind besonders nützlich für HTTP-Aktivitäten. Weitere Informationen zur Verwendung von Jitterbit-Variablen finden Sie unter Jitterbit-Variablen.

Diese Jitterbit-Variablen beeinflussen die Art und Weise, wie HTTP-Quellübermittlungen durchgeführt werden:

  • jitterbit.source.max_redirs
  • jitterbit.source.http.ssl_cert_id
  • jitterbit.source.http.transfer_timeout

Diese Jitterbit-Variablen beeinflussen die Art und Weise, wie HTTP-Zielübermittlungen durchgeführt werden:

  • 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.ssl_cert_id
  • jitterbit.target.http.transfer_timeout

Nächste Schritte

Nachdem Sie eine HTTP-POST-Aktivität konfiguriert haben, können Sie diese innerhalb einer Operation oder eines Skripts wie unten beschrieben verwenden. Sie möchten möglicherweise auch Chunking konfigurieren, um die Daten in kleinere Teile zum Verarbeiten aufzuteilen.

Operation abschließen

Nachdem Sie eine HTTP-POST-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten oder Werkzeuge als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Sobald eine HTTP POST-Aktivität erstellt wurde, sind die Menüaktionen für diese Aktivität im Projektbereich entweder in den Registerkarten Workflows oder Komponenten sowie von der Entwurfskanvas aus zugänglich. Siehe Aktionsmenü der Aktivität für Details.

Die Betriebsarten, mit denen HTTP POST-Aktivitäten verwendet werden können, hängen davon ab, ob die Aktivität Daten (als Quelle) bereitstellt oder Daten (als Ziel) empfängt, wie unten in Verwendet als Quelle und Verwendet als Ziel beschrieben.

Obwohl es typisch ist, dass HTTP POST-Aktivitäten als Ziel verwendet werden, ist es möglich, eine HTTP POST-Aktivität als Quelle zu verwenden. Ob der spezifische Webdienst Anforderungs- oder Antwortschemata für jede Methode bereitstellt, bestimmt, ob eine Aktivität als Quelle oder Ziel verwendet werden kann, wie in Teile einer Operation in Erstellung und Konfiguration von Operationen beschrieben.

Wenn Sie bereit sind, implementieren und führen Sie die Operation aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.

Verwendet als Quelle

HTTP-Aktivitäten, die als Quelle verwendet werden, können mit diesen Betriebsarten verwendet werden:

Andere Muster sind nicht gültig, wenn HTTP-Aktivitäten als Quelle verwendet werden.

Verwendet als Ziel

HTTP-Aktivitäten, die als Ziel verwendet werden, können mit diesen Betriebsmustern verwendet werden:

Andere Muster sind nicht gültig, wenn HTTP-Aktivitäten als Ziel verwendet werden.

Verwendung von HTTP-Aktivitäten in Skripten

HTTP-Aktivitäten können auch in einem Skript referenziert werden, um mit Skriptfunktionen verwendet zu werden, die eine sourceId oder targetId als Parameter verwenden, einschließlich dieser:

Jitterbit-Funktionen

JavaScript Jitterbit-Funktionen

Für weitere Details zum Referenzieren von Aktivitäten in Skripten siehe Endpoints in Jitterbit Script oder Endpoints in JavaScript.

Chunking verwenden

Viele Webservice-APIs haben Größenbeschränkungen. Wenn Sie auf von der API auferlegte Datensatzgrenzen stoßen, möchten Sie möglicherweise Chunking verwenden, um die Quelldaten in mehrere Teile zu splitten. Die Transformation wird dann für jedes Chunk separat durchgeführt, wobei jedes Quellchunk ein Zielchunk erzeugt. Die resultierenden Zielchunks kombinieren sich, um das endgültige Ziel zu erzeugen.

Für Anweisungen und bewährte Verfahren zur Verwendung von Chunking siehe Betriebsoptionen.