HTTPAntwortknoten (HTTPReply)

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Mit dem HTTPAntwortknoten können Sie eine Antwort aus dem Nachrichtenfluss an den Webdienstclient zurückgeben. Dieser Knoten generiert die Antwort an den Webdienstclient, von dem aus die Eingabenachricht an den HTTPEmpfangsknoten gesendet wurde, und wartet auf die Sendebestätigung.

Wenn Sie einen HTTPAntwortknoten in einen Nachrichtenfluss einfügen, müssen Sie entweder einen HTTPEmpfangsknoten in demselben Fluss einfügen, oder die Nachricht muss von einem anderen Fluss empfangen werden, der mit einem HTTPEmpfangsknoten beginnt. Die Reaktion wird der Antwort über eine Anforderungskennung zugeordnet, die vom HTTPEmpfangsknoten in der lokalen Umgebung gespeichert wird.

Dieser Knoten erstellt für den Webdienstclient eine Antwortnachricht auf Basis der gesamten Nachrichtenbaumstruktur der Eingabe, die an den Anforderer zurückgegeben wird.

Der HTTPAntwortknoten wird in Workbench durch folgendes Symbol dargestellt:

Symbol für HTTPAntwortknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Der Abschnitt zum HTTPEmpfangsknoten enthält Beispiele zur Verwendung dieses Knotens.

HTTPAntwortknoten konfigurieren

Wenn Sie eine Instanz des HTTPAntwortknotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Klicken Sie mit der rechten Maustaste in der Editoransicht auf den Knoten, und wählen Sie die Option Eigenschaften aus. Daraufhin werden die grundlegenden Eigenschaften des Knotens angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind dort mit einem Sternchen gekennzeichnet.

Konfigurieren Sie den HTTPAntwortknoten wie folgt:

  1. Wählen Sie das Markierungsfeld Transportfehler ignorieren aus, wenn transportbezogene Fehler ignoriert werden sollen (wenn beispielsweise zum Client keine Verbindung besteht). Wenn Sie das Markierungsfeld inaktivieren und ein transportbezogener Fehler auftritt, wird die Eingabenachricht an das Fehlerterminal weitergegeben. Wenn Sie das Markierungsfeld inaktivieren, müssen Sie für Zeitlimit für Antwortübergabe einen Wert angeben.
  2. Legen Sie den Wert Zeitlimit für Antwortübergabe fest, wenn Transportfehler nicht ignoriert werden sollen. Dies bezeichnet die Zeit, die der Knoten auf die Bestätigung warten soll, dass die Antwort vom Client empfangen wurde. Wird die Bestätigung innerhalb dieser Zeitspanne empfangen, wird die Eingabenachricht über das Ausgangsterminal (falls verbunden) an den übrigen Nachrichtenfluss weitergegeben. Wird die Bestätigung nicht innerhalb dieser Zeitspanne empfangen, wird die Eingabenachricht über das Fehlerterminal weitergegeben, falls dieses verbunden ist. Wenn das Fehlerterminal nicht verbunden ist und nicht rechtzeitig eine Bestätigung eingeht, wird eine Ausnahmebedingung generiert.
  3. Wenn die standardmäßigen Header des Webdienstes mit Werten aus dem HTTPReplyHeader oder dem HTTPResponseHeader erstellt werden sollen, müssen Sie sicherstellen, dass das Kontrollkästchen HTTP-Standard-Header auf Basis der Antwort generieren aktiviert ist. Wenn der entsprechende Header nicht in der Eingabenachricht vorhanden ist, werden Standardwerte verwendet.

    Der Knoten enthält im HTTPReplyHeader immer einen Header des Typs 'Content-Length', der auf den richtigen errechneten Wert gesetzt ist, selbst wenn dies nicht Bestandteil der ursprünglichen Anforderung war.

  4. Wählen Sie im Eigenschaften-Dialognavigator die Option "Auswertung", wenn der MRM-Parser den Nachrichtenhauptteil gegen das von der Nachrichtengruppe generierte Wörterbuch prüfen soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Sie finden detaillierte Informationen hierzu unter Nachrichten überprüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.

  5. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Beschreibung' aus, um ein kurze und/oder ausführliche Beschreibung einzugeben.
  6. Klicken Sie auf Übernehmen, um die Änderungen am HTTPAntwortknoten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld mit den Eigenschaften zu schließen.

    Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.

Die Ausgabeterminals mit einem anderen Knoten verbinden

Schließen Sie das Ausgangs- oder Fehlerterminal dieses Knotens an einen anderen Knoten in diesem Nachrichtenfluss an, wenn Sie die Nachricht weiterverarbeiten, Fehler verarbeiten oder die Nachricht an eine weitere Zieladresse senden möchten.

Terminals und Eigenschaften

In der nachfolgenden Tabelle werden die Terminals des HTTPAntwortknotens 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.
Ausgangsterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich übergeben wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist

In der nachfolgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen im Eigenschaftendialog, ob Sie einen Wert eingeben müssen, wenn kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie der BAR-Datei den Nachrichtenfluss hinzufügen, um ihn einzusetzen).

In der nachfolgenden Tabelle werden die grundlegenden Eigenschaften des HTTPAntwortknotens beschrieben.

Eigenschaft M C Standard Beschreibung
Transportfehler ignorieren Ja Nein Ausgewählt Gibt an, ob transportbezogene Fehler ignoriert werden. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Zeitlimit für Antwortübergabe Ja Nein 120 Die Zeit (in Sekunden), die der Antwortknoten 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. Nur gültig, wenn das Markierungsfeld Transportfehler ignorieren nicht ausgewählt ist.
HTTP-Standard-Header auf Basis von Antwort generieren Ja Nein Ausgewählt Das Kontrollkästchen ist aktiviert, wenn die Header für den standardmäßigen Web-Service mit Hilfe der Werte vom HTTPReplyHeader oder HTTPResponseHeader erstellt wurden.

In der nachfolgenden Tabelle werden die Auswertungseigenschaften des HTTPAntwortknotens beschrieben.

Der Abschnitt Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne enthält eine ausführliche Beschreibung der Eigenschaften.

Eigenschaft O K Standardwert Beschreibung
Auswerten Ja Ja Übernehmen Durchführung einer Auswertung. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen.
Aktion bei Fehler Ja Nein Ausnahme Aktion beim Fehlschlagen einer Gültigkeitsprüfung. 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.
Alle Wertvorgaben einschließen Ja Nein Ausgewählt Diese Eigenschaft kann nicht bearbeitet werden. Die Standardaktion (ausgewähltes Markierungsfeld) besteht darin, dass in der Auswertung von Inhalt und Wert auch Basisprüfungen der Wertvorgaben ausgeführt werden.
Korrektur Ja Nein Keine Diese Eigenschaft kann nicht bearbeitet werden.

Die Beschreibungseigenschaften des HTTPAntwortknotens werden in der folgenden Tabelle beschrieben.

Eigenschaft M C Standard Beschreibung
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac04585_