Verwenden Sie den SOAPInput-Knoten zur Verarbeitung von Client-SOAP-Nachrichten und machen Sie dadurch den Broker zu einem SOAP-Web-Service-Anbieter.
Der SOAPInput-Knoten wird in der Regel in Verbindung mit dem SOAPReply-Knoten verwendet.
Der SOAPInput-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 SOAPInput-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.
Zum Überschreiben dieser Eigenschaft müssen Sie den [<Pfad>] abgeben.
Wenn die Adresse eine HTTPS-URL enthält, ist das Kontrollkästchen aktiviert, anderenfalls nicht.
Wenn Sie den Wert dieser Eigenschaft jedoch manuell überschreiben, wird er nicht mehr dem entsprechenden Service-Port angepasst.
Vordefinierte Rollen sind in den entsprechenden SOAP 1.1- oder SOAP 1.2-Spezifikationen angegeben und werden zur Verarbeitung von SOAP-Headern verwendet, die an die entsprechende Rolle gerichtet sind.
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.
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.
In einem solchen Fall wird eine Ausnahmeliste mit der ankommenden Nachricht als BLOB an das Fehlerterminal gesandt. Der Standardwert dieser Eigenschaft ist inaktiviert.
Der Standardwert ist Inhalt und Wert.
Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.
In der folgenden Tabelle werden die Terminals des SOAPInput-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 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 SOAPInput-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 SOAPInput-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 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:
|
|
| 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 | Ja | 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 SOAPInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| URL-Selektor | Ja | Ja | None (Keinen) | Diese Eigenschaft legt die HTTP-Pfadauswahl fest, nach der der Knoten ankommende Nachrichten annimmt. |
| HTTPS verwenden | Nein | Ja | Nicht ausgewählt | Wenn die Adresse eine HTTPS-URL enthält, ist das Kontrollkästchen aktiviert, anderenfalls nicht. |
| Maximale Client-Wartezeit(Sekunden) | Ja | Ja | 180 | Die Zeit, die der Client bis zur Antwort eines fernen Servers mit der Bestätigung 'Empfangene Nachricht' wartet. |
In der folgenden Tabelle werden die erweiterten Eigenschaften des SOAPInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| SOAP 1.1-Actor (SOAP 1.2-Aufgabenbereich) | Ja | Nein | Letztendliche Zieladresse (Letztendlicher Empfänger) | Die SOAP-Rolle des Empfängers. |
| Zieladressenliste einrichten | Nein | Nein | Ausgewählt | Gibt an, ob die Methode 'Bindungsname' zur Zieladressenliste für die Weiterleitung an Zieladressen hinzugefügt werden soll. Wird dieses Kontrollkästchen aktiviert, wird die Methode 'Bindungsname' hinzugefügt, so dass Sie einen RouteToLabel-Knoten nach dem SOAPInput-Knoten im Nachrichtenfluss verwenden können. |
| Präfix | Nein | Nein | None (Keinen) | Das Präfix, das bei der Weiterleitung an den Kennsatz an den Namen der Methode angefügt wird. Fügen Sie ein Zieladressenpräfix hinzu, um Konflikte zwischen den jeweiligen Zieladressenknoten zu vermeiden, wenn Sie mehrere WebSphere Adapters-Empfangsknoten in denselben Nachrichtenfluss aufnehmen. Das Zieladressenpräfix wird standardmäßig nicht eingefügt; der Methodenname und die Zielbezeichnung sind also identisch. |
| 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 Zeilen hinzufügen, bearbeiten und löschen. Diese Eigenschaft wird in der CMF-Datei generiert. |
In der folgenden Tabelle werden die WS-Erweiterungseigenschaften des SOAPInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| WS-Adressierung verwenden | Nein | Nein | Nicht ausgewählt | Diese Eigenschaft legt fest, ob die WS-Adressierung verwendet wird. |
| WS-Sicherheit | 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 Eingabenachricht' des SOAPInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Nachrichtendomäne | Nein | Nein | SOAP | Die Domäne für die Syntaxanalyse der ankommenden Nachricht. 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 ankommende Nachricht definiert ist. |
| Nachrichtentyp | Nein | Nein | Der Name der ankommenden Nachricht. Der Nachrichtentyp wird vom Knoten automatisch erkannt. Diese Eigenschaft kann nicht festgelegt werden. | |
| Nachrichtenformat | Nein | Nein | Der Name des physischen Formats der ankommenden Nachricht. Diese Eigenschaft kann nicht festgelegt werden. |
In der folgenden Tabelle werden die Parseroptionseigenschaften des SOAPInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Zeitpunkt für Syntaxanalyse | Nein | Nein | Bei Bedarf | Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht 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 mit Hilfe von XML-Schemadatentypen erstellen | Nein | Nein | Ausgewählt | 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 | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er gemischten Text in einer Eingabenachricht feststellt. 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 | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in einer Eingabenachricht 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 | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in einer Eingabenachricht 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 Eingabenachricht fest, die nicht transparent analysiert werden sollen. |
In der folgenden Tabelle wird die Fehlerbehandlungseigenschaft des SOAPInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Fehler während der Verarbeitung ankommender SOAP-Nachrichten an Fehlerterminal senden | Nein | Ja | Nicht ausgewählt | Senden Sie Fehler während der Verarbeitung ankommender SOAP-Nachrichten an das Fehlerterminal |
In der folgenden Tabelle werden die Validierungseigenschaften des SOAPInput-Knotens beschrieben. Weitere Informationen hierzu finden Sie unter Auswertungseigenschaften.
| 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 | Nein | 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, Ausnahmebedingung und Ausnahmeliste. |
In der folgenden Tabelle werden die Instanzeigenschaften des SOAPInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Pool zusätzlicher Instanzen | Nein | Ja | Pool verwenden, der dem Nachrichtenfluss zugeordnet ist | Der Pool, aus dem zusätzliche Instanzen bereitgestellt werden sollen.
|
| Zusätzliche Instanzen | Nein | Ja | 0 | Die Anzahl der zusätzlichen Instanzen, die der Knoten starten kann, wenn für die Eigenschaft 'Pool zusätzlicher Instanzen' 'Pool verwenden, der dem Knoten zugeordnet ist' angegeben wurde. Standardmäßig werden dem Knoten keine zusätzlichen Instanzen zugeordnet. |
In der folgenden Tabelle werden die Wiederholungseigenschaften des SOAPInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Description |
|---|---|---|---|---|
| Wiederholungsmechanismus | Nein | Nein | Failure | Diese Eigenschaft gibt an, wie die Wiederholungsverarbeitung erfolgen soll, wenn ein Fehler zum SOAPInput-Knoten zurückgesetzt wird.
|
| Wiederholungsgrenzwert | Nein | Ja | 0 | Die maximale Anzahl der Verarbeitungsversuche bei einem kurzen Wiederholungsintervall. |
| Kurzes Wiederholungsintervall | Nein | Ja | 0 | Das Intervall zwischen zwei kurzen Wiederholungsversuchen |
| Langes Wiederholungsintervall | Nein | Ja | 0 | Das Intervall zwischen zwei langen Wiederholungsversuchen |