Verwenden Sie den HTTPReply-Knoten, um eine Antwort vom Nachrichtenfluss an einen HTTP-Client zurückzugeben. Dieser Knoten generiert die Antwort für einen HTTP-Client, von dem die Eingabenachricht durch den HTTPInput-Knoten empfangen wurde, und wartet auf die Bestätigung, dass sie gesendet wurde.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Der HTTPReply-Knoten kann in jedem Nachrichtenfluss verwendet werden, der HTTP- oder HTTPS-Nachrichten annehmen muss. Das häufigste Beispiel hierfür ist ein Nachrichtenfluss, durch den ein Web-Service implementiert wird. Weitere Informationen zu Web-Service-Anwendungen finden Sie unter Web-Service-Anwendungen.
Wenn Sie einen HTTPReply-Knoten in einen Nachrichtenfluss einfügen, müssen Sie entweder einen HTTPInput-Knoten in demselben Fluss einfügen, oder die Nachricht muss von einem anderen Fluss empfangen werden, der im selben Broker aktiv ist und mit einem HTTPInput-Knoten anfing. Diese Antwort wird durch eine Anforderungs-ID, die in der lokalen Umgebung vom HTTPInput-Knoten gespeichert wird, mit der Antwort verknüpft.
Dieser Knoten erstellt für den Web-Service-Client eine Antwortnachricht auf Basis der gesamten Nachrichtenbaumstruktur der Eingabe, die an den Anforderer zurückgegeben wird.
Der HTTPReply-Knoten befindet sich im HTTP-Fach der Palette und wird in Workbench durch folgendes Symbol dargestellt:
Nachdem Sie eine Instanz des HTTPReplyknotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
Konfigurieren Sie denHTTPReply -Knoten.
Der Knoten fügt in den HTTPReplyHeader immer einen Header des Typs 'Content-Length' ein, der auf den richtigen errechneten Wert gesetzt ist, selbst wenn dies nicht Bestandteil der ursprünglichen Anforderung war.
Nähere Informationen finden Sie unter Nachrichten überprüfen.
In der folgenden Tabelle werden die HTTPReply-Knotenterminals beschrieben .
| Terminal | Beschreibung |
|---|---|
| Eingangsterminal | Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
| Fehlerterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn während der Weitergabe der Nachricht ein Fehler auftritt. |
| Ausgabeterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich übergeben wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des HTTPReply-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Knotentyp, z. B. HTTPReply | Der Name des Knotens. |
| Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
| Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |
In der folgenden Tabelle werden die grundlegenden Eigenschaften des HTTPReply-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Transportfehler ignorieren | Ja | Nein | Ausgewählt | Wenn Sie das Kontrollkästchen aktivieren, werden transportbezogene Fehler ignoriert. |
| Zeitlimit für Senden der Antwort (Sekunden) | Ja | Nein | 120 | Die Zeit in Sekunden, die der HTTPReplyknoten wartet, bis er davon ausgeht, dass die Antwort nicht an den Client zugestellt werden konnte. Der gültige Bereich liegt zwischen null (unendliche Wartezeit) und (231)-1. Diese Eigenschaft ist nur gültig, wenn das Kontrollkästchen Transportfehler ignorieren nicht aktiviert ist. |
| HTTP-Standard-Header auf Basis von Antwort generieren | Ja | Nein | Ausgewählt | Wenn Sie das Kontrollkästchen aktivieren, werden die Header für den standardmäßigen Web-Service mit Hilfe der Werte vom HTTPReplyHeader oder HTTPResponseHeader erstellt. |
In der folgenden Tabelle werden die Auswertungseigenschaften des HTTPReplyknotens beschrieben.
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Auswerten | Nein | Ja | Übernehmen | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. |
| Aktion bei Fehler | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste. |