HTTP-POST-Aktivität

Einführung

Eine HTTP POST-Aktivität unter Verwendung ihrer HTTP-Verbindung, ersetzt eine vorhandene Ressource in einem Dienst, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann, und kann entweder als Quelle (zum Bereitstellen von Daten in einem Operation) oder als Ziel (zum Verwenden von Daten in einem Operation) verwendet werden.

Erstellen einer HTTP-Post-Aktivität

Eine Instanz einer HTTP POST-Aktivität wird aus einer HTTP-Verbindung erstellt mithilfe des Aktivitätstyps „POST“.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

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

• Die Design-Canvas (siehe Aktionsmenü „Komponentenaktionen“ in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

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 legen Sie die Einstellungen fest
  Geben Sie einen Namen für die Aktivität an und geben Sie die URL, Anforderungsparameter und Anforderungsheader an.

• Schritt 2: Geben Sie das Schema an
  Stellen Sie ein benutzerdefiniertes Schema bereit.

• Schritt 3: Geben Sie das Schema an
  Stellen Sie ein benutzerdefiniertes Schema bereit.

• Schritt 4: Überprüfen Sie die Datenschemata
  Die konfigurierten Anfrage- und Antwortschemata (sofern vorhanden) werden angezeigt.

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und geben Sie die URL, Anforderungsparameter und Anforderungsheader an. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

• Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede HTTP POST-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

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

  Notiz

  Bei einem als Quelle verwendeten HTTP-POST wird eine leere Anfrage an die URL gesendet und die Antwort als Quelle verwendet.

  Bei einem als Ziel verwendeten HTTP POST kann praktisch jede Art von Payload enthalten sein, die jedoch vom empfangenden Webserver verstanden werden muss. Basierend auf der HTTP-Anforderung wird eine Antwort zurückgegeben, die von Harmony analysiert wird. Wenn die Antwort Erfolg anzeigt, wird nichts weiter unternommen. Wenn eine Fehlermeldung empfangen wird, wird sie als Teil des Fehlerprotokollierungsprozesses für den Operation verwendet und in Operation gemeldet.

• Pfad: Geben Sie einen Pfad und/oder Abfrage ein, die an die Basis URL angehängt werden sollen, die in der Konfiguration der HTTP-Verbindung angegeben wurde. Wenn Sie Abfrage 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 wird, dient als Referenz. Um die URL zu bearbeiten, nehmen Sie Änderungen entweder an der Basis URL in der HTTP-Verbindung vor oder an den oben eingegebenen Pfad.

• Anforderungsparameter: Klicken Sie auf die Schaltfläche Hinzufügen, um eine Zeile hinzuzufügen, und geben Sie dann einen bestimmten 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 bestimmten Namen und Wert für die angeforderten Header Informationen ein. Klicken Sie auf die Schaltfläche Entfernen, um eine vorhandene Zeile zu entfernen.

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

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

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Angeben des Schema

In diesem Schritt können Sie ein benutzerdefiniertes Schema angeben (optional).

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

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

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

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Angeben des Schema

In diesem Schritt können Sie ein benutzerdefiniertes Schema angeben (optional).

• Antwortschema bereitstellen: Das Schema definiert die Struktur der Antwortdaten, die von der HTTP-Aktivität verwendet werden. Ob ein Schema 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 Schemaverwendung). Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemata.

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

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

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 4: Überprüfen der Datenschemata

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

• Datenschema: Sofern während der Aktivitätskonfiguration angegeben, werden die Anforderungs- und/oder Antwortdatenschemata angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während der Transformation erneut angezeigt-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können. Sie können auch Schemata direkt in einer Transformation definieren.

• Plugin(s) hinzufügen: Plugins sind von Jitterbit oder vom Benutzer bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen aller erforderlichen Variablen, die vom Plugin verwendet werden, finden Sie unter Zu einer Aktivität hinzugefügte Plugins.

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

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

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Jitterbit-Variablen, die sich auf die HTTP-Übermittlung auswirken

Das Harmony-System definiert bestimmte globale Variablen, die in einem Projekt immer verfügbar sind und als Jitterbit-Variablen oder vordefinierte globale Variablen bezeichnet werden. 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 sie wie unten beschrieben in einem Operation oder Script verwenden. Möglicherweise möchten Sie auch die chunking konfigurieren, um die Daten zur Verarbeitung in kleinere Blöcke aufzuteilen.

Schließen Sie den Operation ab

Nachdem Sie eine HTTP POST-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie weitere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Sobald eine HTTP POST-Aktivität erstellt wurde, sind Menüaktionen für diese Aktivität über den Projektbereich entweder auf den Registerkarten Workflows oder Komponenten sowie über die Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Einzelheiten.

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

Obwohl es üblich ist, HTTP-POST-Aktivitäten als Ziel zu verwenden, ist es möglich, eine HTTP-POST-Aktivität als Quelle zu verwenden. Ob der jeweilige 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 beschrieben in Operationserstellung und -konfiguration.

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

Als Quelle verwendet

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

• Archivmuster
• Transformation
• Zwei-Ziel-Archivmuster (nur als erste Quelle)
• HTTP-Archivmuster mit zwei Zielen (als erste oder zweite Quelle)
• Zwei-Transformationsmuster (nur als erste Quelle)
• Salesforce Massenzielmuster

Andere Muster sind bei Verwendung von HTTP-Aktivitäten, die als Quelle verwendet werden, nicht gültig.

Als Ziel verwendet

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

• Archivmuster
• Script
• Transformation
• Zwei-Ziel-Archivmuster (nur als zweites Ziel)
• HTTP-Archivmuster mit zwei Zielen (als erstes oder zweites Ziel)
• Zwei-Transformationsmuster (nur als zweites Ziel)
• Salesforce Massenquellenmuster

Andere Muster sind bei Verwendung von HTTP-Aktivitäten, die als Ziel verwendet werden, nicht gültig.

Verwenden von HTTP-Aktivitäten in Scripts

Auf HTTP-Aktivitäten kann auch in einem Script verwiesen werden zur Verwendung mit Script, die eine sourceId oder targetId als Parameter, einschließlich dieser:

Jitterbit-Funktionen

• ArchiveFile
• Base64EncodeFile
• DBLoad
• DBWrite
• DeleteFile
• DeleteFiles
• DirList
• FileList
• FlushAllFiles
• FlushFile
• ReadFile
• SfLookupAllToFile
• WriteFile

JavaScript Jitterbit-Funktionen

• Jitterbit.ReadFile
• Jitterbit.WriteFile

Weitere Einzelheiten zum Referenzieren von Aktivitäten in Scripts finden Sie unter Endpoints in Jitterbit Script oder Endpoints in JavaScript.

Verwenden von chunking

Viele Webdienst-APIs unterliegen Größenbeschränkungen. Wenn Sie an die von der API vorgegebenen Datensatzbeschränkungen stoßen, können Sie die Quelldaten mithilfe von chunking in mehrere Chunks aufteilen. Die Transformation wird dann für jeden Chunk separat durchgeführt, wobei jeder Quellchunk einen Zielchunk erzeugt. Die resultierenden Zielchunks werden kombiniert, um das endgültige Ziel zu erzeugen.

Anweisungen und Best Practices zur Verwendung von chunking finden Sie unter Operationsoptionen.