Mit dem SOAPRequest-Knoten können Sie eine SOAP-Anforderung an den fernen Web-Service senden. Bei dem Knoten handelt es sich um einen synchronen Anforderungs- und Antwortknoten, der blockiert, bis die Antwort eingegangen ist.
Der SOAPRequest-Knoten ist im Ablagefach Web-Services der Nachrichtenflussknotenpalette 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.
Nachdem Sie eine Instanz des SOAPRequest-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten 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.
Beachten Sie, dass sich beide Seiten einer SSL-Verbindung auf die Verwendung eines Protokolls einigen müssen, damit das ausgewählte Protokoll vom fernen Server akzeptiert werden kann.
Als Trennzeichen zwischen den Chiffrierwerten wird ein Komma verwendet. Der Standardwert ist eine leere Zeichenfolge. Er erlaubt es dem Knoten, während des SSL-Verbindungs-Handshakes einen beliebigen oder alle verfügbaren Chiffrierwerte zu verwenden. Dadurch steht der größtmögliche Bereich für die Herstellung einer erfolgreichen SSL-Verbindung zur Verfügung.
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.
Der Standardwert ist Inhalt und Wert.
In der folgenden Tabelle werden die Terminals des SOAPRequest-Knotens beschrieben.
| Terminal | Description |
|---|---|
| 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 Wenn im Empfangsknoten keine Fehler auftreten, wird eine von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgangsterminal gesandt. |
| 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 Stern, 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 zu implementieren).
In der folgenden Tabelle werden die Beschreibungseigenschaften des SOAPRequest-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 SOAPRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Name der WSDL-Datei | Ja | Nein | <Keines> | 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 dem Feld sind alle Porttypen aufgeführt, die in der mit der Eigenschaft Name der WSDL-Datei festgelegten WSDL-Datei definiert sind. Fehlerbedingungen:
|
| Importierte Bindung | Ja | Nein | Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft wird bei jeder Änderung des Wertes Porttyp aktualisiert. In diesem Feld sind alle dem ausgewählten Porttyp zugeordneten SOAP-Bindungen mit HTTP-Transport (6.1) aufgeführt. . Bindungen sind in derselben Reihenfolge aufgelistet, in der sie in der WSDL-Datei auftreten. Es wird die Bindung ausgewählt, die sowohl über Ports als auch über Operationen verfügt. Wenn keine derartige Bindung vorhanden ist, wird eine Bindung ausgewählt, die über Ports verfügt. Sind keine Bindungen mit Ports vorhanden, wird die erste Bindung auf der Liste ausgewählt. 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. Das Portfeld wird bei jeder Aktualisierung der ausgewählten Bindung aktualisiert. In diesem Feld sind alle WSDL-Ports aufgeführt, die auf die ausgewählte Bindung verweisen. Der erste Port für die Bindung ist standardmäßig der ausgewählte Port. Fehlerbedingungen:
|
|
| Zielnamespace | Ja | Nein | Zielnamespace ist als Anzeigefeld implementiert. Bei diesem ausgeblendeten Eigenschaftentyp handelt es sich um eine Zeichenfolge. Sie wird bei der Konfiguration der Eigenschaft Name der WSDL-Datei mit dem Zielnamespace der WSDL-Datei aktualisiert. |
In der folgenden Tabelle werden die HTTP-Transporteigenschaften des SOAPRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Web-Service-URL | Ja | Ja | SOAP-Adresse des ausgewählten Ports | Die URL der ausgewählten SOAP-Adresse. |
| Zeitlimit für Anforderung (in Sekunden) | Nein | Ja | 180 | Die Zeit, die der Client bis zur Antwort eines fernen Servers mit der Bestätigung 'Empfangene Nachricht' wartet. |
| HTTP(S)-Proxyadresse | Nein | Ja | Die Adresse des Proxy-Servers. | |
| Protokoll (bei Verwendung von SSL) | Nein | Ja | SSL | Das ausgewählte Protokoll, wenn Sie SSL verwenden |
| Erlaubte SSL-Verschlüsselungen (bei Verwendung von SSL) | Nein | Ja | None (Keinen) | Die spezielle SSL-Verschlüsselung oder -Verschlüsselungen, die Sie verwenden. |
In der folgenden Tabelle werden die erweiterten Eigenschaften des SOAPRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| WSDL-definierte SOAP-Header | Nein | Nein | Diese Tabelle ist schreibgeschützt und wird durch die SOAP-Header belegt, die in dem Ausgabeteil der ausgewählten Operationen definiert sind. Die Tabelle wird bei der Aktualisierung der ausgewählten Operation automatisch aktualisiert. Diese Eigenschaft wird in der CMF-Datei generiert. | |
| Benutzerdefinierte SOAP-Header | Nein | Ja | None (Keinen) | In dieser Tabelle können Sie benutzerdefinierte Header hinzufügen. In dieser Tabelle können Sie die Optionen Hinzufügen, Bearbeiten und Löschen verwenden. Diese Eigenschaft wird in der CMF-Datei generiert. |
In der folgenden Tabelle werden die WS-Erweiterungseigenschaften des SOAPRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| WS-Adressierung verwenden | Nein | Nein | Diese Eigenschaft legt fest, ob die WS-Adressierung verwendet wird. | |
| WS Security | Nein | Ja | Diese komplexe Eigenschaft ist in Form einer Tabelle vorhanden und besteht aus zwei Spalten:
|
In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Antwortnachricht' des SOAPRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Nachrichtendomäne | Nein | Nein | SOAP | Die Domäne für die Syntaxanalyse der Antwortnachricht. Die Nachricht, die vom SOAPInput-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 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 SOAPRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| 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 | Nachrichtengruppe | Durch diese Eigenschaft wird gesteuert, ob die Syntaxelemente in der Nachrichtenbaumstruktur Datentypen aus dem XML-Schema enthalten. |
| 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 beim Feststellen von Kommentaren in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. 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 beim Feststellen von Verarbeitungsanweisungen in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. 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 Eingabenachricht fest, die nicht transparent analysiert werden sollen. Diese Eigenschaft ist inaktiviert, es sei denn Auswerten ist auf Keine gesetzt. |
In der folgenden Tabelle werden die Validierungseigenschaften des SOAPRequest-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| 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, Lokales Fehlerprotokoll, Ausnahme und Ausnahmeliste. |