SOAPAsyncResponse-Knoten

Über den SOAPAsyncResponse-Knoten können Sie in Verbindung mit dem SOAPAsyncRequest-Knoten ein Nachrichtenflusspaar erstellen, das einen Web-Service asynchron aufruft.

Zweck

Der SOAPAsyncRequest-Knoten sendet eine Web-Service-Anforderung, wartet jedoch nicht auf den Empfang der entsprechenden Web-Service-Antwort. Stattdessen wartet der SOAPAsyncRequest-Knoten vor der Fortsetzung des Nachrichtenflusses auf die HTTP 202-Bestätigung. Erhält der SOAPAsyncRequest-Knoten diese Bestätigung nicht, blockiert er den Nachrichtenfluss. Die Web-Serviceantwort wird vom SOAPAsyncResponse-Knoten empfangen, der sich in einem separaten Nachrichtenfluss befinden kann. Die Knoten werden als Paar verwendet und stellen eine Korrelation zwischen den Antworten und den ursprünglichen Anforderungen her.

Diagramm, das die Beziehung zwischen dem SOAPAsynchronousRequest- und dem SOAPAsynchronousResponse-Knoten veranschaulicht.

Der SOAPAsyncResponse-Knoten ist im Ablagefach Web-Services der Palette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für Knoten 'SOAPAsyncResponse'

Diesen Knoten in einem Nachrichtenfluss verwenden

Das folgende Beispiel veranschaulicht die Verwendung der asynchronen SOAP-Knoten für den Aufruf eines Web-Services. Der Web-Service simuliert einen Bestellservice, und der Client zeigt, wie vorhandene WebSphere MQ-Schnittstellen erweitert werden, damit sie Web-Service-Anforderungen ausgeben können.

Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

SOAPAsyncResponse-Knoten konfigurieren

Wenn Sie eine Instanz des SOAPAsyncResponse-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

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

Die Konfiguration des SOAPAsyncResponse-Knotens ist nicht WSDL-gesteuert, obwohl die auf dem entsprechenden SOAPAsyncRequest-Knoten konfigurierte Liste 'must understand headers' (must understand-Header) auf den SOAPAsyncResponse-Knoten anwendbar ist.

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine Ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Geben Sie auf der RegisterkarteGrundeinstellungen folgende Eigenschaft an:
    • Eindeutige ID. Sie müssen das eindeutige URL-Fragment angeben, das Ihr Knotenpaar SOAPAsyncRequest-Knoten und SOAPAsyncResponse-Knoten gemeinsam hat. Diese Eigenschaft muss angegeben werden.
  3. Auf der Registerkarte Erweitert können Sie folgende Eigenschaften angeben:
    • Zieladressenliste festlegen. Bei diesem Eigenschaftentyp handelt es sich um einen Booleschen Wert. Diese Eigenschaft gibt an, ob die eingehende SOAP-Operation der Liste mit den Zieladressen hinzugefügt werden soll, an die eine Weiterleitung erfolgen soll.
    • Zieladressenpräfix. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Es handelt sich um ein Präfix, das dem Namen der Operation in der Zielliste hinzugefügt wird. Wenn in einem Nachrichtenfluss mehrere SOAPInput-Knoten verwendet werden sollen, müssen Sie ein Zieladressenpräfix hinzufügen, damit keine Konflikte bei den entsprechenden Zieladressenknoten auftreten.

      Das Standardpräfix ist eine leere Zeichenfolge, so dass Operation- und Kennungsname identisch sind. Im Feld wird jedoch die Benutzeranweisung: <gegebenenfalls Präfix eingeben> angezeigt. Diese Eigenschaft ist nicht aktiviert, wenn die Eigenschaft Zieladressenliste festlegen nicht aktiviert ist.

  4. Auf der Registerkarte Instanzen können Sie folgende Eigenschaften angeben:
    • Pool zusätzlicher Instanzen. Diese Eigenschaft hat die folgenden Werte:
      • Pool verwenden, der dem Nachrichtenfluss zugeordnet ist. Der Standardwert.
      • Pool verwenden, der dem Knoten zugeordnet ist.
    • Zusätzliche Instanzen. Diese Eigenschaft hat den Standardwert0.
  5. Die Eigenschaften auf der Registerkarte Syntaxanalyse der Antwortnachricht werden vom Knoten automatisch festgelegt; Sie können sie nicht selbst setzen.
    • Nachrichtendomäne ist immer auf "SOAP" gesetzt. Weitere Informationen hierzu finden Sie unter SOAP-Parser und -Domäne.
    • Nachrichtengruppe wird automatisch auf die Nachrichtengruppe mit der WSDL-Datei gesetzt, die auf dem entsprechenden SOAPAsyncRequest-Knoten konfiguriert ist.
    • Nachrichtentyp und Nachrichtenformat werden nicht verwendet.
    Tipp: Für die Analyse des XML-Inhalts des SOAP-Web-Services ruft der SOAP-Parser den XMLNSC-Parser auf.
  6. Auf der untergeordneten Registerkarte Parser-Optionen der Registerkarte Syntaxanalyse der Antwortnachricht werden folgende Eigenschaften festgelegt:
    • Zeitpunkt für Syntaxanalyse. Bei diesem Eigenschaftentyp handelt es sich um eine Aufzählung. Wählen Sie Bei Bedarf, Sofort oder Vollständig aus. Der Zeitpunkt für die Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt, d. h., die Analyse der Eingabenachricht wird verzögert. Nähere Informationen finden Sie unter Bedarfsgerechte Syntaxanalyse.
    • Legen Sie für die Eigenschaften Werte fest, die die Funktionsweise des SOAP-Parsers bestimmen. Die SOAP-Parseroptionen werden an den XMLNSC-Parser weitergeleitet. Der Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten enthält weitere Informationen hierzu.
  7. Legen Sie auf der Registerkarte Auswertung die Auswertungseigenschaften fest, wenn der SOAP-Parser den Hauptteil jeder Antwortnachricht anhand des von der Nachrichtengruppe generierten XML-Schemas überprüfen soll. (Falls eine Nachricht an das Fehlerterminal des Knotens weitergegeben wird, wird diese nicht ausgewertet.) Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.
    Tipp: Für die Auswertung des XML-Hauptteils des SOAP-Web-Services ruft der SOAP-Parser den XMLNSC-Parser auf.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des SOAPAsyncResponse-Knotens beschrieben.

Terminal Beschreibung
Fehlerterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn während der Weitergabe der Nachricht ein Fehler auftritt.
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich übergeben wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist.
Fehler SOAP-Fehlernachrichten werden an den Fehlerendpunkt übertragen.
Catch-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde.

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 SOAPAsyncResponse-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp Der Name des Knotens.
Kurzbeschreibung Nein Nein None (Keinen) Kurze Beschreibung des Knotens.
Ausführliche Beschreibung Nein Nein None (Keinen) Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.

In der folgenden Tabelle werden die Grundeinstellungseigenschaften des SOAPAsyncResponse-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Eindeutige ID Ja Nein   Geben Sie das eindeutige URL-Fragment an, das Ihr Knotenpaar SOAPAsyncRequest-Knoten und SOAPAsyncResponse-Knoten gemeinsam hat.

In der nachfolgenden Tabelle wird die erweiterte Eigenschaft des SOAPAsyncResponse-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Zieladressenliste einrichten Nein Nein Ausgewählt Kontrollkästchen. Mit dieser Booleschen Eigenschaft können Sie die eingehenden SOAP-Operationen zur Zieladressenliste hinzufügen.
Präfix Nein Nein   Mit dieser Eigenschaft legen Sie fest, ob den Namen der SOAP-Operationen in der Zieladressenliste ein Präfix hinzugefügt wird. Wenn in einem Nachrichtenfluss mehrere SOAPAsyncResponse-Knoten verwendet werden sollen, müssen Sie ein Zieladressenpräfix hinzufügen, damit es zu keinen Konflikten bei den entsprechenden Kennung-Knoten kommt. Das Präfix ist standardmäßig eine leere Zeichenfolge. Operations- und Kennungsname sind in diesem Fall identisch. Die Eigenschaft steht nicht zur Verfügung, wenn die Eigenschaft Zieladressenliste festlegen inaktiviert ist.

In der folgenden Tabelle werden die Instanzeigenschaften des SOAPAsyncResponse-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Pool zusätzlicher Instanzen Nein Ja Pool verwenden, der dem Nachrichtenfluss zugeordnet ist Diese Eigenschaft hat die folgenden Werte:
  • Pool verwenden, der dem Nachrichtenfluss zugeordnet ist.
  • Pool verwenden, der dem Knoten zugeordnet ist.
Zusätzliche Instanzen Nein Ja 0  

In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Antwortnachricht' des SOAPAsyncResponse-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein SOAP Die Domäne für die Syntaxanalyse der Antwortnachricht. Die Nachricht, die vom SOAPAsyncResponse-Knoten weitergegeben wird, befindet sich standardmäßig in der SOAP-Domäne. Sie können keine andere Domäne angeben.
Nachrichtengruppe Ja Nein Wird automatisch durch die vom SOAPAsyncRequest-Knoten bereitgestellte Eigenschaft Name der WSDL-Datei festgelegt. Der Name der Nachrichtengruppe, in der die Antwortnachricht definiert ist.
Nachrichtentyp Nein Nein   Der Name der Antwortnachricht. Der Nachrichtentyp wird vom Knoten automatisch erkannt. Diese Eigenschaft kann nicht festgelegt werden.
Nachrichtenformat Nein Nein   Der Name des physischen Formats der Antwortnachricht. Diese Eigenschaft kann nicht festgelegt werden.

In der folgenden Tabelle werden die Parseroptionseigenschaften des SOAPAsyncResponse-Knotens beschrieben. Die Eigenschaften werden an den XMLNSC-Parser weitergeleitet.

Eigenschaft M C Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Antwortnachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig.

Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse.

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser die Datentypen der in der Nachrichtenbaumstruktur erstellten Syntaxelemente aus dem XML-Schema entnimmt.
Zugriff auf gemischten Inhalt Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von gemischtem Text in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt.
Kommentare beibehalten Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in einer Antwortnachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt.
Verarbeitungsanweisung beibehalten Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in einer Antwortnachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.
Nicht transparente Elemente Nein Nein   Diese Eigenschaft legt eine Liste der Elemente der Antwortnachricht fest, die vom XMLNSC-Parser nicht transparent analysiert werden sollen. Diese Eigenschaft ist nur verfügbar, wenn Auswerten auf Keine gesetzt wurde.

In der folgenden Tabelle werden die Validierungseigenschaften des SOAPAsyncResponse-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Auswertung Nein Ja Inhalt und Wert Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert und Inhalt.
Fehlerbehebungsmaßnahme Nein Ja Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Diese Eigenschaft kann nur angegeben werden, wenn Auswerten auf Inhalt oder Inhalt und Wert gesetzt ist. Gültige Werte sind Benutzertrace, Ausnahmeliste, Lokales Fehlerprotokoll und Ausnahmebedingung.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac56210_