Mit dem SOAPAsyncRequest-Knoten können Sie in Verbindung mit dem SOAPAsyncResponse-Knoten ein Nachrichtenflusspaar erstellen, das einen Web-Service asynchron aufruft.
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 Fortführung des Nachrichtenflusses auf die HTTP 202-Bestätigung. Erhält der SOAPAsyncRequest-Knoten diese Bestätigung nicht, blockiert er den Nachrichtenfluss. Die Web-Service-Antwort wird von dem SOAPAsyncResponse-Knoten empfangen, der sich auch 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.

Der SOAPAsyncRequest-Knoten ist die erste Hälfte des asynchronen Anforderungs- und Antwortknotenpaars. Der SOAPAsyncRequest-Knoten ruft einen fernen SOAP-basierten Web-Service auf. Die Anforderung wird vom SOAPAsyncRequest-Knoten gesendet, der SOAPAsyncRequest-Knoten ist nicht der Empfänger der Antwort. Die Antwort wird von einem SOAPAsyncResponse-Knoten empfangen, der auf einem anderen Thread aktiv ist. Der SOAPAsyncResponse-Knoten befindet sich in der Regel am Anfang eines anderen Nachrichtenflusses. Dieser Nachrichtenfluss muss allerdings der gleichen Ausführungsgruppe angehören wie der SOAPAsyncRequest-Knoten.
Der SOAPAsyncRequest-Knoten ist, ähnlich wie der SOAPRequest-Knoten, WSDL-gesteuert.
Der SOAPAsyncRequest-Knoten ist im Ablagefach Web-Services der Palette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:
Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.
Wenn Sie eine Instanz des SOAPAsyncRequest-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.
Wenn Sie für das Feld Name der WSDL-Datei eine WSDL-Datei auswählen, wird die ausgewählte WSDL überprüft, um sicherzustellen, dass sie WS-I-konform ist. Die übrigen Eigenschaften der Registerkarte Grundeinstellung werden automatisch auf Basis der WSDL-Definition eingestellt.
Zur Konfiguration der SOAP-Knoten muss eine implementierbare WSDL-Datei verwendet werden. Mittels einer implementierbaren WSDL-Datei können Sie die Eigenschaft 'Name der WSDL-Datei' mit einer der folgenden Methoden einstellen:
Nach Auswahl einer gültigen WSDL-Datei wird das Nachrichtengruppenprojekt, zu dem die WSDL-Datei gehört, dem entsprechenden Nachrichtenflussprojekt als Projekt, auf das verwiesen wird, hinzugefügt, sofern der Verweis noch nicht vorhanden ist.
Bei einer ungültigen WSDL-Datei oder Eingabe eines falschen Dateinamens wird in der Eigenschaftenanzeige eine Fehlernachricht angezeigt und die WSDL-Eigenschaften bleiben leer.
Beide Seiten einer SSL-Verbindung müssen dasselbe Protokoll verwenden. Der ferne Server muss das Protokoll akzeptieren können.
SOAP-Header, die in der Liste must understand headers (Muss Header verstehen) enthalten sind, werden dem Nachrichtenfluss hinzugefügt und verursachen keinen SOAP-Fehler. Das Hinzufügen von Headern zur Liste must understand headers (Muss Header verstehen) ist somit ein wirkungsvolles Mittel, um durch SOAP-Header verursachte SOAP-Fehler zu verhindern.
Für WS-Adressierung und WS-Sicherheit brauchen Sie der Liste must understand headers (Muss Header verstehen) keine Header hinzuzufügen, da diese ohnehin erkannt werden, wenn Sie WS-Erweiterungen konfigurieren.
Die in diesem Knoten konfigurierte Eigenschaft must understand headers (Muss Header verstehen) wird auf den entsprechenden SOAPAsyncResponse-Knoten angewendet, wenn der SOAPAsyncResponse-Knoten die Antwort vom fernen Server empfängt.
In der folgenden Tabelle werden die Terminals des SOAPAsyncRequest-Knotens beschrieben.
| Terminal | Description |
|---|---|
| In | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
| Fehlerterminal | Das Ausgabeterminal, an das eine Nachricht geleitet wird, wenn ein Fehler beim Weitergeben der Nachricht an den Ausgangsfluss festgestellt wird (z. B. ein Fehler bei der Gültigkeitsprüfung einer Nachricht). Zu Fehlern, die an dieses Terminal weitergeleitet werden, gehören diejenigen, die dadurch verursacht werden, dass die Wiederholungsverarbeitung stattfindet, bevor die Wiederholung die Nachricht an den Ausgangsfluss weitergeleitet hat. |
| Ausgang | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich in die Ausgabewarteschlange eingereiht wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist Die Nachricht, die das Ausgangsterminal verlässt, ist identisch mit der Nachricht, die am Eingabeterminal ankommt. Wenn im Empfangsknoten keine Fehler auftreten, wird eine von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgangsterminal gesandt. |
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 SOAPAsyncRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| 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 grundlegenden Eigenschaften des SOAPAsyncRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Eindeutige ID | Ja | Nein | Geben Sie das eindeutige URL-Fragment an, das Ihr Knotenpaar SOAPAsyncRequest-Knoten und SOAPAsyncResponse-Knoten gemeinsam hat. | |
| Name der WSDL-Datei | Ja | Nein | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Wenn Sie für das Feld Name der WSDL-Datei eine WSDL-Datei auswählen, wird die ausgewählte WSDL überprüft, um sicherzustellen, dass sie WS-I-konform ist. Zur Konfiguration der SOAP-Knoten muss eine implementierbare WSDL-Datei verwendet werden. Nach Auswahl einer gültigen WSDL-Datei wird das Nachrichtengruppenprojekt, zu dem die WSDL-Datei gehört, dem entsprechenden Nachrichtenflussprojekt als Projekt, auf das verwiesen wird, hinzugefügt, sofern der Verweis noch nicht vorhanden ist. | |
| Porttyp | Ja | Nein | Standardmäßig wird der erste in der WSDL-Datei gefundene Porttyp ausgewählt, dem eine HTTP-Bindung zugeordnet ist. | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. In diesem Feld sind alle in der angegebenen WSDL-Datei definierten Porttypen aufgeführt. Standardmäßig wird der erste in der WSDL-Datei gefundene Porttyp ausgewählt, dem eine HTTP-Bindung zugeordnet ist. Fehlerbedingungen:
|
| Importierte Bindung | Ja | Nein | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Im Feld Importierte Bindung sind alle dem ausgewählten Porttyp zugeordneten SOAP-Bindungen aufgeführt. Nur HTTP-Transport wird unterstützt. Die Bindungen sind in derselben Reihenfolge aufgelistet, in der sie in der WSDL-Datei definiert sind. Standardmäßig wird die erste Bindung ausgewählt, die die jeweilige Operation implementiert und der ein Service-Port zugeordnet ist.
Diese Eigenschaft wird bei jeder Änderung des Porttyp-Wertes aktualisiert. Fehlerbedingungen:
|
|
| Bindungsoperation | Ja | Nein | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Das Feld Bindungsoperation enthält alle durch die ausgewählte Bindung definierten Operationen. Die erste Operation auf der Liste wird standardmäßig ausgewählt. |
|
| Service-Port | Ja | Nein | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Im Feld Service-Port sind alle Service-Ports aufgelistet, die auf die
ausgewählte Bindung verweisen. Standardmäßig ist der erste Service-Port der Bindung ausgewählt. Diese Eigenschaft wird bei jeder Änderung des Bindungswerts aktualisiert. Fehlerbedingungen:
|
|
| Zielnamespace | Nein | Nein | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Im Feld Zielnamespace wird der Namespace der ausgewählten WSDL-Datei angezeigt. |
In der folgenden Tabelle werden die HTTP-Transporteigenschaften des SOAPAsyncRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Web-Service-URL | Ja | Nein | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft wird automatisch aus dem <soap:address>-Element des ausgewählten Service-Ports abgeleitet. Bei einer Änderung des ausgewählten Ports wird die Web-Service-URL entsprechend angepasst. Wenn Sie den Wert jedoch manuell überschreiben, bleibt der von Ihnen festgelegte Wert erhalten und die URL wird nicht mehr dem Service-Port angepasst. Der Wert muss, wenn Sie ihn manuell angeben, folgendes Format haben: http://<Hostname>[:<Port>]/[<Pfad>]. Dabei gilt Folgendes:
|
|
| Zeitlimit für Anforderung (in Sekunden) | Nein | Nein | 120 | Bei diesem Eigenschaftentyp handelt es sich um eine ganze Zahl. Diese Eigenschaft enthält den Wert der Wartezeit, die verstreicht, bis der ferne Server mit einer Nachrichtenempfangsbestätigung antwortet. Die Zeit in Sekunden, die der Knoten auf eine Antwort vom Web-Service wartet. Der gültige Bereich liegt zwischen 1 und (231)-1. Werte, die eine unbegrenzte Wartedauer angeben, sind nicht zulässig. |
| HTTP(S)-Proxyadresse | Nein | Nein | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Die Adresse des Proxy-Servers fest, an den Anforderungen gesendet werden. Dieser Wert muss das Format Hostname:Port haben. | |
| SSL-Protokoll (bei Verwendung von SSL) | Nein | Nein | SSL | Bei diesem Eigenschaftentyp handelt es sich um eine Aufzählung. SSL-Protokoll bei der Erstellung einer HTTPS-Anforderung. Gültige Werte sind:
|
| Erlaubte SSL-Verschlüsselungen (bei Verwendung von SSL) | Nein | Nein | Leer | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Eine durch Kommas getrennte Liste von Verschlüsselungen, die bei der Erstellung einer SSL-Anforderung verwendet wird. Wenn der Standardwert eine leere Zeichenfolge ist, werden alle verfügbaren Verschlüsselungen verwendet. |
In der folgenden Tabelle werden die erweiterten Eigenschaften des SOAPAsyncRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| WSDL-definierte SOAP-Header | Nein | Nein | Die Tabelle WSDL-definierte SOAP-Header ist schreibgeschützt und wird auf der Grundlage der SOAP-Header ausgefüllt, die in dem Ausgabeteil der ausgewählten Operationen definiert sind. Standardmäßig sind die Kontrollkästchen in der zweiten Tabellenspalte für alle Einträge der Tabelle WSDL-definierte SOAP-Header inaktiviert. Sie müssen die Kontrollkästchen der Header, die Sie der Liste must understand headers (Muss Header verstehen) hinzufügen möchten, also explizit aktivieren. | |
| Benutzerdefinierte SOAP-Header | Nein | Nein | Sie können benutzerdefinierte Header (Header, die nicht in der WSDL-Datei definiert sind) zur Tabelle Benutzerdefinierte SOAP-Header hinzufügen. In dieser Tabelle können Sie Zeilen hinzufügen, bearbeiten und löschen. In der zweiten Tabellenspalte muss das Kontrollkästchen für den neu hinzugefügten benutzerdefinierten Header aktiviert sein, damit der Header zu der Liste must understand headers (Muss Header verstehen) hinzugefügt wird. |
In der folgenden Tabelle werden die WS-Erweiterungseigenschaften des SOAPAsyncRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| WS-Adressierung verwenden | Nein | Nein | Ausgewählt | Diese Eigenschaft kann nicht bearbeitet werden. Mit dieser Eigenschaft geben Sie an, dass die WS-Adressierung für den SOAPAsyncRequest-Knoten immer aktiviert ist. |
| WS-Sicherheit | Nein | Nein | Diese Tabelle enthält zwei Spalten:
|