WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

SOAPInput-Knoten

Verwenden Sie den SOAPInput-Knoten zur Verarbeitung von Client-SOAP-Nachrichten und machen Sie auf diese Weise den Broker zu einem SOAP-Web-Service-Provider.

Zweck

Der SOAPInput-Knoten wird für gewöhnlich in Verbindung mit dem SOAPReply-Knoten verwendet, der in denselben Nachrichtenfluss oder in einen anderen Fluss in derselben Ausführungsgruppe aufgenommen werden kann.

Sie können einen SOAPReply-Knoten mit dem Ausgangsterminal verbinden, um erfolgreiche Antworten verarbeiten zu können. Wenn Ihr Nachrichtenfluss außerdem eine Antwortverarbeitung nach einer Zeitlimitüberschreitung handhaben soll, verbinden Sie einen SOAPReply-Knoten mit dem HTTPTimeout-Terminal.

Der HTTPReply-Knoten eignet sich nicht für die Antwort auf eine Web-Service-Anforderung, die von einem SOAPInput-Knoten empfangen wird; der Broker generiert eine Ausnahmebedingung, wenn versucht wird, zu antworten.

Wenn Sie SOAP-Knoten und HTTP-Knoten in Nachrichtenflüssen auf einem einzelnen Broker verwenden, können Sie festlegen, ob die Verarbeitung von HTTP-Nachrichten über das Empfangsprogramm des Brokers oder über die eingebetteten Empfangsprogramme der Ausführungsgruppen erfolgt. Wenn ein Empfangsprogramm in Ihrer Konfiguration Nachrichten empfängt, die sowohl von SOAPInput- als auch von HTTPInput-Knoten abgerufen werden könnten, müssen die URL-Spezifikationen in diesen Knoten genau überprüft werden. Wenn beide URL-Spezifikationen einer eingehenden Nachricht entsprechen, besteht die Gefahr, dass der falsche Knotentyp die Nachricht erhält und die Verarbeitung fehlschlägt oder zu unerwarteten Ergebnissen führt. Diese Situation entsteht, wenn Sie identische Werte für die Eigenschaften Pfadsuffix für URL des HTTPInput-Knotens und des SOAPInput-Knotens angeben. Dies ist im Übrigen auch der Fall, wenn Sie in einer der beiden Spezifikationen Platzhalterzeichen verwenden und eine eingehende Nachricht dadurch beiden Eigenschaften entspricht.

Der SOAPInput-Knoten ist im Ablagefach Web-Services der Nachrichtenflussknotenpalette enthalten und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für SOAPInput-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Der SOAPInput-Knoten kann in jedem Nachrichtenfluss verwendet werden, der SOAP-Nachrichten annimmt und verarbeitet. Der Knoten wurde durch implementierbare WSDL konfiguriert. Das folgende Beispiel zeigt, wie dieser Knoten verwendet wird:

Ein Client kann eine HTTP GET-Anforderung mit dem Suffix ?wsdl an den vom SOAPInput-Knoten angebotenen Web Service-Endpunkt senden und eine Antwort mit der WSDL-Definition empfangen, die zur Konfiguration des Datenflusses verwendet wird; vergleichen Sie hierzu Nachrichtenflüsse unter Verwendung von WSDL konfigurieren.

Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.

Ein Client kann eine Anforderung mit der Inhaltscodierung "gzip" oder "deflate" (komprimiert) senden. Beim Empfang einer solchen Anforderung wird der Inhalt entschlüsselt und der Content-Encoding-Header entfernt.

Für eingehende Nachrichten, die vom SOAPInput-Knoten verarbeitet werden, können Sie WS-RM (Reliable Messaging) konfigurieren. Weitere Informationen hierzu finden Sie unter Web Services Reliable Messaging.

Für die Verwaltung von HTTP-Nachrichten haben Sie die Wahl zwischen dem brokerweiten Empfangsprogramm und dem Ausführungsgruppen-Empfangsprogramm. SOAP-Knoten verwenden standardmäßig das Ausführungsgruppen-Empfangsprogramm. Der Abschnitt HTTP-Empfangsprogramme enthält weitere Informationen hierzu.

Verbindungen zu Terminals herstellen

Der SOAPInput-Knoten leitet jede Nachricht, die er erfolgreich empfängt, an das Ausgangsterminal weiter. Schlägt die Nachrichtenauswertung fehl, wird die Nachricht an das Fehlerterminal (Failure) weitergeleitet. Sie können Knoten mit diesem Terminal verbinden, um diese Situation zu handhaben. Wenn keine Verbindung zum Fehlerterminal besteht, wird die Nachricht gelöscht, die maximale Wartezeit für den Client läuft ab und dem Client wird ein Fehler gemeldet.

Wenn die Nachricht von diesem Knoten abgefangen wird, nachdem eine Ausnahmebedingung weiter vorne im Nachrichtenfluss ausgelöst wurde, wird die Nachricht an das Catch-Terminal weitergeleitet. Wenn keine Verbindung zum Catch-Terminal besteht, wird die Nachricht gelöscht, die maximale Wartezeit für den Client läuft ab und dem Client wird ein Fehler gemeldet.

Wenn die maximale Wartezeit für den Client abläuft, sendet das Empfangsprogramm eine SOAP-Fehlernachricht an den Client, in der darauf hingewiesen wird, dass das Zeitlimit abgelaufen ist. Wenn Sie das HTTPTimeout-Terminal verbunden haben und den HTTP-Transport verwenden, wird die SOAP-Fehlernachricht durch das HTTPTimeout-Terminal weitergegeben. Sie müssen einen SOAPReply-Knoten in die Reihe der Knoten aufnehmen, die mit dem HTTPTimeout-Terminal verbunden sind, und dieser Knoten muss eine gültige SOAP-Fehlernachricht senden. Das Empfangsprogramm wartet erneut, und zwar in dem Intervall, das jeweils kürzer ist: Entweder gilt das in der Eigenschaft Maximale Clientwartezeit (Sek) definierte Intervall oder das Intervall von 10 Sekunden.
  • Wenn vor Ablauf dieses zweiten Intervalls eine Antwort eingeht, übergibt das Empfangsprogramm die Antwort an den Client.
  • Wenn vor Ablauf dieses zweiten Intervalls keine Antwort eingeht, sendet das Empfangsprogramm eine SOAP-Fehlernachricht an den Client, in der darauf hingewiesen wird, dass das Zeitlimit abgelaufen ist.
Da das Empfangsprogramm nur für einen kurzen Zeitraum nach Weitergabe der Nachricht durch das HTTPTimeout-Terminal wartet, müssen Sie sicherstellen, dass die Folge der Knoten, die Sie mit dem HTTPTimeout-Terminal verbinden, einen SOAPReply-Knoten umfasst, der vor Ablauf dieses Intervalls eine Antwort sendet. Wenn Sie das HTTPTimeout-Terminal verbunden haben, den HTTP-Transport jedoch nicht verwenden, wird die Nachricht nicht durch das HTTPTimeout-Terminal weitergegeben. Das Empfangsprogramm sendet eine SOAP-Fehlernachricht an den Client, die darauf hinweist, dass das zugehörige Zeitlimit abgelaufen ist.

Terminals und Eigenschaften

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

Name Typ Beschreibung
Fehlerterminal (Failure) Ausgabedaten Das Ausgabeterminal, an das eine SOAP-Nachricht weitergeleitet wird, wenn bei der Weitergabe der empfangenen Nachricht an das Ausgabeterminal ein Fehler erkannt wird (z. B. bei der Gültigkeitsprüfung der Nachricht).
Ausgang Ausgabedaten Das Ausgabeterminal, an das die SOAP-Nachricht weitergeleitet wird, wenn sie erfolgreich empfangen wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist. Wenn im Empfangsknoten keine Fehler auftreten, wird eine gültige SOAP-Nachricht, die von einer externen Ressource empfangen wurde, immer zuerst an das Ausgangsterminal gesendet.
HTTPTimeout Ausgabedaten Das Ausgabeterminal, an das eine SOAP-Fehlernachricht zur Zeitlimitüberschreitung weitergeleitet wird, wenn der SOAPReply-Knoten, der mit dem Ausgangsterminal verbunden ist, nicht innerhalb des Zeitintervalls reagiert, das durch die Eigenschaft Maximale Wartezeit für Client festgelegt ist. Dieses Terminal wird nur verwendet, wenn die Nachricht über den HTTP-Transport gesendet und WS-RM nicht verwendet wird. Dieses Terminal funktioniert nur mit einem integrierten Ausführungsgruppenlistener. Wenn ein brokerweiter Listener für SOAP-Knoten konfiguriert wird, hat dieses Terminal keine Auswirkung.
Catch-Terminal Ausgabedaten Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgelöst und von diesem Knoten abgefangen wurde.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

Einige Eigenschaften des SOAPInput-Knotens werden anfänglich durch Eigenschaften der importierten WSDL festgelegt. Diese Eigenschaften werden je nach URI-Format des address-Elements der WSDL auf verschiedene Weisen syntaktisch analysiert. Ausführliche Informationen hierzu finden Sie unter WSDL-URI-Formate für JMS.

Folgende Wiederholungseigenschaften sind auf dem SOAPInput-Knoten nicht mehr verfügbar:
  • Wiederholungsmechanismus
  • Wiederholungsschwellenwert
  • Kurzes Wiederholungsintervall
  • Langes Wiederholungsintervall
Wenn eine SOAP over HTTP-Nachricht fehlschlägt, wird ein SOAP-Fehler an den Client zurückgesendet; das Nachrichtenaustauschmuster ist vollständig und es gibt keine Nachricht, die wiederholt werden müsste. Wenn eine SOAP over JMS-Nachricht fehlschlägt, erfolgt eine Wiederholungsverarbeitung gemäß den Backout-Eigenschaften, die auf der Registerkarte 'JMS-Transport' festgelegt sind.

In der folgenden Tabelle werden die Beschreibungseigenschaften des SOAPInput-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Der Knotentyp; SOAPInput Der Name des Knotens.
Kurzbeschreibung Nein Nein Ohne Kurze Beschreibung des Knotens.
Langbeschreibung Nein Nein Ohne Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.

In der folgenden Tabelle werden die grundlegenden Eigenschaften des SOAPInput-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Betriebsmodus Ja Ja Die verfügbar zu machende WSDL-Schnittstelle angeben

Mit dieser Eigenschaft können Sie den Betriebsmodus des Knotens angegeben, der bestimmt, ob er im WSDL-Modus oder im Gateway-Modus agiert. Im WSDL-Modus führt der Knoten Operationen entsprechend der WSDL-Datei durch, mit der er konfiguriert ist. Mit dem Gateway-Modus können Sie Ihren Nachrichtenfluss jedoch so konfigurieren, dass er generische SOAP-Anforderungs-/Antwortnachrichten und unidirektionale Nachrichten verarbeitet oder als Fassade zwischen mehreren Web-Service-Clients und mehreren Back-End-Web-Service-Providern fungiert.

Die verfügbar zu machende WSDL-Schnittstelle angeben
Konfigurieren Sie den Knoten mit einer implementierbaren WSDL-Datei, indem Sie die Eigenschaft 'Name der WSDL-Datei' festlegen oder eine WSDL-Datei auf den Knoten ziehen. Dies ist die Standardoption.
Im Gateway-Modus betreiben
Konfigurieren Sie den Knoten so, dass der im Gateway-Modus agiert, ohne dass eine WSDL-Datei erforderlich ist. Eine ausführlichere Erläuterung des Gateway-Modus finden Sie im Abschnitt Gateway-Betriebsmodus für SOAP-Knoten.
Name der WSDL-Datei Ja Nein Ohne

Diese Eigenschaft gibt die Position der WSDL-Datei an, die zum Konfigurieren des Knotens verwendet werden soll. Geben Sie den vollständigen Pfad der WSDL-Datei ein oder klicken Sie auf Durchsuchen, um in Ihrem Arbeitsbereich nach der WSDL-Datei zu suchen.

Wenn Sie für die Eigenschaft Name der WSDL-Datei eine WSDL-Datei auswählen, wird die ausgewählte WSDL überprüft, um sicherzustellen, dass sie WS-I-konform ist. Wenn die WSDL eine SOAP/JMS-Bindung enthält, die nicht mit WS-I konform ist, wird standardmäßig kein Fehler angezeigt. Wenn Sie eine strenge WS-I-Prüfung aktivieren möchten und eine Warnung angezeigt werden soll, wenn ein SOAP/JMS-Transport verwendet wird, klicken Sie auf Fenster > Einstellungen > Brokerentwicklung > Nachrichtengruppen > Auswertung und heben Sie die Auswahl des Kontrollkästchens WS-I BP 1.1: SOAP/JMS als Transport-URI zulassen auf.

Zur Konfiguration der SOAP-Knoten können nur implementierbare WSDL-Dateien verwendet werden. Nach Auswahl einer gültigen WSDL-Datei wird das Nachrichtengruppenprojekt, zu dem die WSDL-Datei gehört, als referenziertes Projekt der entsprechenden Anwendung oder Bibliothek hinzugefügt, sofern der Verweis 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.

Für diese Eigenschaft muss ein Zeichenfolgewert angegeben werden.

Folgende Situationen führen zu einer Fehlerbedingung:

WSDL-Eigenschaften werden inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

Porttyp Ja Nein Der erste Porttyp, der in der WSDL-Datei gefunden wird (und dem eine HTTP-Bindung zugeordnet ist). Diese Eigenschaft listet alle in der angegebenen WSDL-Datei definierten Porttypen auf. Standardmäßig wird der erste in der WSDL-Datei gefundene Porttyp ausgewählt, dem eine HTTP- bzw. JMS-Bindung zugeordnet ist. Für diese Eigenschaft muss ein Zeichenfolgewert angegeben werden.
Die folgende Situation verursacht eine Fehlerbedingung:
  • Der ausgewählte Porttyp enthält nicht mindestens eine Operation.
Beim Speichern der Nachrichtenflussdatei werden einige der WSDL-spezifischen Eigenschaften überprüft, um Folgendes sicherzustellen:
  • Die WSDL-Datei ist in der Nachrichtengruppe vorhanden.
  • Die ausgewählten Eigenschaften Porttyp, Bindungsoperation und Service-Port sind alle im Inhalt der ausgewählten WSDL-Datei gültig.
Falls eine oder mehrere dieser Bedingungen nicht zutreffen, wird ein Fehler ausgegeben. Sie können dann keinen Nachrichtenfluss mit diesem SOAPInput-Knoten zu einer Brokerarchivdatei (BAR-Datei) hinzufügen.

WSDL-Eigenschaften werden inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

Importierte Bindung Ja Nein   Die Eigenschaft Importierte Bindung listet alle dem ausgewählten Porttyp zugeordneten importierten SOAP-Bindungen auf. Nur HTTP- oder JMS-Transport wird unterstützt. Wenn Sie eine Bindung auswählen, wird die Registerkarte zu den Eigenschaften des zugehörigen Transports aktiviert; andernfalls ist sie inaktiviert.

Bindungen werden in der Reihenfolge aufgelistet, in der sie in der WSDL-Datei definiert sind. Standardmäßig wird die erste importierte Bindung ausgewählt, die die jeweilige Operation implementiert und der ein Service-Port zugeordnet ist. Diese Eigenschaft wird bei jeder Änderung des Porttyp-Werts aktualisiert. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge.

Folgende Situationen verursachen eine Fehlerbedingung:
  • Dem Porttyp sind in der WSDL-Datei keine importierten SOAP-Bindungen (mit HTTP- oder JMS-Transport) zugeordnet.
  • Die ausgewählte Bindung verfügt über keine Operationen.

WSDL-Eigenschaften werden inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

Service-Port Ja Nein   Im Feld Service-Port werden alle Service-Ports, die auf die ausgewählte Bindung verweisen, aufgelistet. Standardmäßig ist der erste Service-Port der Bindung ausgewählt. Diese Eigenschaft wird bei jeder Änderung des Bindungswerts aktualisiert. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge.
Die folgende Situation verursacht eine Fehlerbedingung:
  • Es gibt keine Ports, die auf die ausgewählte Bindung verweisen.

WSDL-Eigenschaften werden inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

Zielnamespace Ja Nein   Diese Eigenschaft zeigt den Namespace der ausgewählten WSDL-Datei an. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge.

WSDL-Eigenschaften werden inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

Transport Nein Nein   Diese Eigenschaft wird bei Auswahl der Eigenschaft Importierte Bindung automatisch festgelegt. Der Wert dieser Eigenschaft gibt den von der ausgewählten WSDL-Bindung verwendeten Transport an, sofern eine solche Bindung ausgewählt ist; Beispiel: HTTP oder JMS.

Wenn Sie den Transport von JMS in HTTP ändern, wird ein Dialogfenster angezeigt, in dem Sie die JMS-spezifischen Eigenschaften zurücksetzen können. Sie müssen die JMS-Eigenschaften zurücksetzen, um den Nachrichtenfluss in einer Version der Laufzeitumgebung vor Fixpack V7.0.0.1 zu implementieren.

In der folgenden Tabelle werden die HTTP-Transporteigenschaften des SOAPInput-Knotens beschrieben. Diese Einstellungen werden nur verwendet, wenn der Knoten den HTTP-Transport verwendet.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Pfadsuffix für URL Ja Ja Ohne Pfadsuffix für URL bezeichnet die HTTP-Pfadauswahl, an dem der Knoten eingehende Nachrichten annimmt. Diese Eigenschaft wird automatisch aus dem <soap:address>-Element des ausgewählten Service-Ports festgelegt. Bei einer Änderung des ausgewählten Ports wird URL-Selektor entsprechend angepasst. Wenn Sie diesen Wert jedoch manuell überschreiben, bleibt der von Ihnen festgelegte Wert erhalten und die URL wird nicht mehr dem Service-Port angepasst.

Zum Überschreiben dieser Eigenschaft müssen Sie den [<Pfad>] abgeben.

Wenn Sie in mehreren Nachrichtenflüssen denselben HTTP-Pfad für Knoten konfigurieren, wird eine bei diesem Endpunkt eingehende Anforderung möglicherweise von jedem dieser Nachrichtenflüsse verarbeitet. Werden die Nachrichtenflüsse unterschiedlich konfiguriert, verarbeiten Sie die Nachricht unterschiedlich, was zu einem unvorhersehbaren Verhalten führen kann.

Wenn Sie für einen einzelnen HTTP-Pfad zusätzliche Ressourcen benötigen, können Sie zusätzliche Instanzen konfigurieren, statt mehrere Nachrichtenflüsse zu erstellen. Der Abschnitt Konfigurierbare Nachrichtenflusseigenschaften enthält weitere Informationen hierzu.

urlSelector
HTTPS verwenden Nein Ja Nicht ausgewählt Diese Eigenschaft hat einen booleschen Wert und wird automatisch aus dem <soap:address>-Element des ausgewählten Service-Ports konfiguriert. Wenn die Adresse eine HTTPS-URL enthält, ist das Kontrollkästchen aktiviert, andernfalls nicht. Wenn Sie den Wert dieser Eigenschaft jedoch manuell überschreiben, wird er nicht mehr dem entsprechenden Service-Port angepasst.

Führen Sie die folgenden Schritte aus, um das HTTPS-Protokoll zu aktivieren, wenn diese Eigenschaft ausgewählt wird:

  1. Erstellen Sie einen neuen Schlüsselspeicher vom Typ "jks" und wählen Sie ein Kennwort aus.
  2. Erstellen Sie ein neues selbst signiertes Zertifikat mit einer Bezeichnung Ihrer Wahl.
  3. Führen Sie den folgenden Befehl aus: mqsichangeproperties Brokername -o BrokerRegistry -n brokerKeystoreFile -v Schlüsselspeicherdatei
  4. Führen Sie den folgenden Befehl aus: mqsichangeproperties Brokername -o BrokerRegistry -n brokerTruststoreFile -v Schlüsselspeicherdatei
  5. Führen Sie den folgenden Befehl aus: mqsisetdbparms Brokername -n brokerKeystore::password -u na -p Schlüsselspeicherkennwort
  6. Führen Sie den folgenden Befehl aus: mqsisetdbparms Brokername -n brokerTruststore::password -u na -p Schlüsselspeicherkennwort
  7. Implementieren Sie Ihren Nachrichtenfluss auf dem Broker.
  8. Dieser Prozess verwendet TLS und nicht SSL. Führen Sie zur Aktivierung von SSL den folgenden Befehl aus: mqsichangeproperties Brokername -e Ausführungsgruppe -o HTTPSConnector -n sslProtocol -v SSL. Wenn Ihr Nachrichtenfluss einen SOAPRequest-Knoten verwendet, sollten Sie auch den Wert der Eigenschaft Protokoll auf dem SOAPRequest-Knoten ändern.
useHTTPS
Maximale Client-Wartezeit(Sekunden) Ja Ja 180 Die Zeit, die der Client bis zur Antwort eines fernen Servers mit der Bestätigung "Nachricht empfangen" wartet. Der gültige Zeitraum ist null (d. h. eine kurze Wartezeit) bis (231)-1. Diese Eigenschaft gibt die maximale Zeit an, die ein TCP/IP-Empfangsprogramm, das die Eingabenachricht vom Web-Service-Client empfangen hat, auf eine Antwort vom SOAPReply-Knoten wartet. Wenn innerhalb dieser Zeit eine Antwort eingeht, übergibt das Empfangsprogramm die Antwort an den Client. Wenn innerhalb dieser Zeit keine Antwort eingeht, wird eine SOAP-Fehlernachricht erzeugt mit der Information, dass das Zeitlimit überschritten wurde. Diese Fehlernachricht wird entweder vom Empfangsprogramm gesendet oder (bei Verwendung des HTTP-Transports) von der Verarbeitung durch das Timeout-Terminal.

Weitere Informationen zum HTTPTimeout-Terminal finden Sie unter Verbindungen zu Terminals herstellen und Terminals und Eigenschaften.

maxClientWaitTime
Unterstützung für ?wsdl aktivieren N J Nicht ausgewählt Nach Auswahl dieser Eigenschaft gibt der Broker als Antwort auf eine HTTP GET-Anforderung mit der Abfragezeichenfolge ?wsdl Informationen zu WSDL und zum XML-Schema zurück, die sich auf diesen Endpunkt beziehen. Damit können Sie die WSDL-Verteilung steuern. Eine ausführliche Beschreibung finden Sie unter Nachrichtenflüsse unter Verwendung von WSDL konfigurieren.

Diese Eigenschaft wird inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

 

In der folgenden Tabelle werden die JMS-Transporteigenschaften des SOAPInput-Knotens beschrieben. Diese Einstellungen werden nur verwendet, wenn der Knoten den JMS-Transport verwendet.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Quelle Ja Nein Ohne

Der Name der Warteschlange, aus der der Knoten eingehende Nachrichten empfängt.

Diese Eigenschaft übernimmt ihren Anfangswert aus einer WSDL-URI-Eigenschaft. Welcher Wert verwendet wird, ist abhängig davon, ob der URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM® Format definiert ist. Bei einem W3C-URI wird Quelle auf den Wert von destinationName der WSDL gesetzt, bei einem IBM URI auf den Wert von destination.

Quelle
Name des JMS-Providers Ja Nein WebSphere MQ Wählen Sie in der Liste den Namen eines JMS-Anbieters aus oder geben Sie einen Namen ein. Wenn Sie in der Liste einen Namen auswählen, wird die Eigenschaft Ausgangskontextfactory automatisch mit der entsprechenden Java™-Klasse aktualisiert. Wenn Sie einen eigenen JMS-Providernamen eingeben, müssen Sie auch einen Wert für die Ausgangskontextfactory eingeben.Der Name muss dem Namen eines konfigurierbaren Service entsprechen, der für den Broker, für den Sie den Nachrichtenfluss implementieren, definiert ist.  
Ausgangskontextfactory Ja Ja com.sun.jndi.fscontext. RefFSContextFactory

Der Ausgangspunkt für einen JNDI-Namespace.

Eine JMS-Anwendung verwendet den Ausgangskontext, um die Verbindungsfactory sowie Warteschlangen oder Themenobjekte für den JMS-Provider abzurufen und zu suchen. Wenn Sie in der Liste unter Name des JMS-Providers den Namen eines JMS-Providers auswählen, wird die Eigenschaft Ausgangskontextfactory automatisch mit der entsprechenden Java-Klasse aktualisiert. Wenn Sie einen eigenen JMS-Providernamen eingeben, müssen Sie auch einen Wert für die Ausgangskontextfactory eingeben.Der Standardwert lautet com.sun.jndi.fscontext.RefFSContextFactory. Mit diesem Wert wird die dateibasierte Ausgangskontextfactory für den JMS-Provider von WebSphere MQ definiert.

Diese Eigenschaft übernimmt ihren Anfangswert aus einer WSDL-URI-Eigenschaft. Welcher Wert verwendet wird, ist abhängig davon, ob der URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM Format definiert ist. Bei einem W3C-URI wird Ausgangskontextfactory auf den in der WSDL gefundenen Wert von jndiInitialContextFactory gesetzt, bei einem IBM URI auf den Wert von initialContextFactory.

initialContextFactory
Position der JNDI-URL-Bindungen Ja Ja   Der Systempfad oder die LDAP-Position für die Bindungsdatei. Die Bindungsdatei enthält Definitionen für die verwalteten JNDI-Objekte, die vom SOAPInput-Knoten verwendet werden.

Wenn für die Ausgangskontextfactory der Wert com.ibm.mq.jms.Nojndi angegeben ist, ist diese Eigenschaft inaktiviert.

Bei der Eingabe eines Werts für die Eigenschaft Position der JNDI-URL-Bindungen sind folgende Anweisungen einzuhalten:
  • Erstellen Sie die Bindungsdatei vor der Implementierung eines Nachrichtenflusses, der einen SOAPInput-Knoten enthält.
  • Geben Sie in diesem Feld nicht den Dateinamen der Bindungsdatei ein.
  • Wenn Sie eine LDAP-Adresse angegeben haben, für die eine Authentifizierung erforderlich ist, konfigurieren Sie den LDAP-Principal (Benutzer-ID) und die LDAP-Berechtigungsnachweise (Kennwort) separat. Diese Werte werden auf Brokerebene konfiguriert. Informationen zur Konfiguration dieser Werte finden Sie in den Abschnitten Befehl mqsicreatebroker und Befehl mqsichangebroker.
  • Der Zeichenfolgewert muss ein unterstütztes URL-Präfix einschließen, das einen im Klassenpfad verfügbaren URL-Handler enthält.

Informationen zum Erstellen der Bindungsdatei für verwaltete JNDI-Objekte finden Sie in der Dokumentation des JMS-Providers.

Diese Eigenschaft übernimmt ihren Anfangswert aus einer WSDL-URI-Eigenschaft. Welcher Wert verwendet wird, ist abhängig davon, ob der URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM Format definiert ist. Bei einem W3C-URI wird Position der JNDI-URL-Bindungen auf den Wert von jndiURL der WSDL gesetzt, bei einem IBM URI auf den Wert von jndiProviderURL.

locationJndiBindings
Verbindungsfactory-Name Ja Ja   Der Name der Verbindungsfactory, der vom SOAPInput-Knoten für die Erstellung einer Verbindung zum JMS-Provider verwendet wird. Diese Eigenschaft wird ursprünglich durch die importierte WSDL konfiguriert. Dieser Name muss in der Bindungsdatei bereits vorhanden sein. Als Verbindungsfactory-Name muss ein JMS-QueueConnectionFactory-Name angegeben sein.

Diese Eigenschaft übernimmt ihren Anfangswert aus einer WSDL-URI-Eigenschaft. Welcher Wert verwendet wird, ist abhängig davon, ob der URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM Format definiert ist. Bei einem W3C-URI wird Verbindungsfactory-Name auf den Wert von jndiConnectionFactoryName der WSDL gesetzt, bei einem IBM URI auf den Wert von connectionFactory.

connectionFactoryName
Rücksetzziel Nein Ja   Wenn der Nachrichtenfluss aufgrund von Fehlern die Nachricht nicht verarbeiten kann, werden Eingabenachrichten vom SOAPInput-Knoten an diese Zieladresse gesendet und die Nachricht muss aus dem Eingabeziel entfernt werden. Der Name des Rücksetzungsziels muss in der Bindungsdatei enthalten sein. backoutDestination
Rücksetzschwellenwert Nein Ja 0

Der Wert, über den gesteuert wird, wann eine Nachricht in das Rücksetzziel gestellt wird. Wenn der Wert beispielsweise 3 lautet, versucht der JMS-Provider drei Mal, die Nachricht an die Eingabezieladresse zuzustellen. Nach dem dritten Zustellungsversuch wird die Nachricht nicht auf die Eingabezieladresse zurückgesetzt und wird an das Rücksetzziel gesendet.

Ein SOAP-Fehler wird nur gesendet, wenn der Rücksetzschwellenwert erreicht wurde.

Weitere Informationen hierzu finden Sie unter Eigenschaft 'Rücksetzschwellenwert' konfigurieren.

 
JNDI-Kontextparameter Nein Nein   Eine Tabelle, welche die JNDI-Kontextparameter ihrem Typ zuordnet. Diese Eigenschaften werden ursprünglich aus der importierten WSDL konfiguriert.

Diese Eigenschaften erhalten ihre Anfangswerte von den WSDL-Eigenschaften im W3C-Format, beginnend mit jndi-. WSDL-URIs im IBM Format unterstützen keine JNDI-Kontextparameter, Sie können diese Eigenschaften jedoch im Knoten festlegen.

 

In der folgenden Tabelle werden die Eigenschaften von 'Nachrichtenselektoren' des SOAPInput-Knotens beschrieben. Diese Registerkarte ist nur aktiviert, wenn die ausgewählte Bindung auf der Registerkarte 'Grundeinstellung' den JMS-Transport verwendet.

Eine Beschreibung, wie der JMS-Nachrichtenselektor erstellt wird, finden Sie im Abschnitt JMS-Nachrichtenselektor.
Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Anwendungseigenschaft Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß dem Wert des Anwendungsmerkmals filtert.

Wenn der JMS-Provider Nachrichten auf der Grundlage der von der initiierenden JMS-Clientanwendung festgelegten Nachrichteneigenschaften filtern soll, geben Sie für die Anwendungseigenschaft eine Selektorzeichenfolge ein, durch die sowohl der Eigenschaftsname als auch die Auswahlbedingungen angegeben werden (z. B. OrderValue > 200).

Geben Sie für die Anwendungseigenschaft keinen Wert ein, wenn der Empfangsknoten keine Auswahl auf der Grundlage der Anwendungseigenschaft treffen soll.

 
Zeitmarke Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß der JMS-Zeitmarke filtert.

Wenn der JMS-Provider Nachrichten filtern soll, die zu bestimmten Zeitpunkten generiert wurden, geben Sie für Zeitmarke eine Selektorzeichenfolge ein. Bei diesem Wert muss es sich um einen nicht näher bestimmten Java-Wert im Millisekunden handeln, z. B. 105757642321. Qualifizieren Sie den Selektor durch Operatoren, z. B. =, BETWEEN oder AND.

Geben Sie für Zeitmarke keinen Wert an, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Zeitmarke (JMSTimeStamp) treffen soll.

 
Zustellmodus Nein Ja Alle Der Nachrichtenselektor, der Nachrichten gemäß dem Nachrichtenübermittlungsmodus filtert.
Wenn der JMS-Provider Nachrichten auf der Grundlage des JMSDeliveryMode-Headerwerts in den JMS-Nachrichten filtern soll, wählen Sie in der Liste eine Option für den Zustellmodus aus:
  • Wählen Sie Nicht persistent aus, wenn nur Nachrichten empfangen werden sollen, die von der initiierenden JMS-Clientanwendung als nicht persistent markiert wurden.
  • Wählen Sie Persistent aus, wenn nur Nachrichten empfangen werden sollen, die von der initiierenden JMS-Clientanwendung als persistent markiert wurden.
  • Wählen Sie Alle aus, wenn persistente und nicht persistente Nachrichten empfangen werden sollen. (Dieser Wert ist der Standardwert.)

Diese Eigenschaft übernimmt ihren Anfangswert aus einer WSDL-URI-Eigenschaft. Welcher Wert verwendet wird, ist abhängig davon, ob die URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM Format definiert ist. Bei einem W3C-URI wird Zustellmodus auf den Wert von deliveryMode der WSDL gesetzt, bei einem IBM URI auf den Wert von deliveryMode oder persistence (je nachdem, welcher Wert zuerst vorkommt).

 
Priorität Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß der Nachrichtenpriorität filtert.

Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSPriority' in der JMS-Nachricht filtern soll, geben Sie für Priorität eine Selektorzeichenfolge ein.

Die gültigen Werte für Priorität liegen zwischen 0 (niedrigste Priorität) und 9 (höchste Priorität). Geben Sie beispielsweise = 5 ein, um Nachrichten der Priorität 5 zu empfangen, > 4, um Nachrichten mit einer Priorität größer als 4 zu empfangen, oder BETWEEN 4 AND 8, um Nachrichten mit einer Priorität im Bereich von 4 bis 8 zu empfangen.

Machen Sie im Feld Priorität keine Angabe, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Priorität (JMSPriority) treffen soll.

Diese Eigenschaft übernimmt ihren Anfangswert aus einer WSDL-URI-Eigenschaft. Welcher Wert verwendet wird, ist abhängig davon, ob der URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM Format definiert ist. Bei einem W3C-URI wird Priorität auf den Wert von priority der WSDL gesetzt, bei einem IBM URI auf den Wert von priority oder Priority (je nachdem, welcher Wert zuerst vorkommt).

 
Nachrichten-ID Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß der Nachrichten-ID filtert.

Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSMessageID' filtern soll, geben Sie für Nachrichten-ID eine Selektorzeichenfolge ein. Geben Sie beispielsweise > WMBRK123456 ein, damit Nachrichten zurückgegeben werden, deren Nachrichten-ID größer als WMBRK123456 ist.

Machen Sie im Feld Nachrichten-ID keine Angabe, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Nachrichten-ID (JMSMessageID) treffen soll.

 
Erneut zugestellt Nein Ja   Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSRedelivered' filtern soll, geben Sie für Erneut zugestellt eine Selektorzeichenfolge ein:
  • Geben Sie = FALSE ein, wenn der Empfangsknoten nur Nachrichten akzeptieren soll, die vom JMS-Provider noch nicht zugestellt wurden.
  • Geben Sie = TRUE ein, wenn der Empfangsknoten nur Nachrichten akzeptieren soll, die vom JMS-Provider bereits zugestellt wurden.
  • Machen Sie im Feld Erneut zugestellt keine Angabe, wenn der Empfangsknoten keine Auswahl auf der Grundlage von 'JMSRedelivered' treffen soll.
 
Korrelations-ID Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß der Korrelations-ID filtert.

Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSCorrelationID' filtern soll, geben Sie für Korrelations-ID eine Selektorzeichenfolge ein. Geben Sie beispielsweise = WMBRKABCDEFG ein, damit Nachrichten zurückgegeben werden, deren Korrelations-ID mit diesem Wert übereinstimmt.

Machen Sie im Feld Korrelations-ID keine Angabe, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Korrelations-ID (JMSCorrelationID) treffen soll.

 
Zielservice Nein Nein   Diese Eigenschaft wird durch den Wert der Eigenschaft targetService konfiguriert, der in der URL des JMS-Endpunktstandorts im Port-Abschnitt der WSDL gefunden wurden. Die SOAP/JMS-Nachricht wird nur dann aus der Quellenwarteschlange eingelesen, wenn für die Nachricht ein Wert targetService definiert ist, der dem auf dem Knoten definierten Wert entspricht. Über diesen Wert bestimmt die Serverkomponente die Portkomponente, der die Anforderung zugeteilt wird.

Diese Eigenschaft erhält ihren Anfangswert aus der WSDL-Eigenschaft targetService.

targetService

In der folgenden Tabelle werden die Transaktionseigenschaften des SOAPInput-Knotens beschrieben. Diese Einstellung gilt nicht, wenn der Knoten den HTTP-Transport verwendet.

Eigenschaft O K Standardwert Beschreibung
Transaktionsmodus Ja Nein Nein

Durch diese Eigenschaft wird gesteuert, ob die Nachricht unter einer JMS-Transaktion empfangen wird. Gültige Werte sind Ja und Nein.

Wählen Sie Nein aus, um die Nachricht mit einer nicht transaktionsorientierten JMS-Sitzung zu empfangen.

Wählen Sie Ja aus, um die Nachricht mit einer transaktionsorientierten JMS-Sitzung zu auszugeben. Die JMS-Transaktion kann entweder lokal oder XA-koordiniert sein. Um eine XA-koordinierte Transaktion mit einer XA-JMS-Sitzung verwenden zu können, müssen Sie in den Eigenschaften der BAR-Datei auch die Nachrichtenflusseigenschaft Koordinierte Transaktion auswählen.

Weitere Informationen hierzu finden Sie unter Koordinierte JMS-Transaktionen konfigurieren.

Der Wert, der für Transaktionsmodus auf dem SOAPInput-Knoten festgelegt ist, wird von den nachgeschalteten Knoten im Nachrichtenfluss übernommen, bei denen Transaktionsmodus auf Automatisch gesetzt ist.

Andere Ressourcen, die Arbeiten im Nachrichtenfluss durchführen, z. B. DB2 oder WebSphere MQ, verwenden Transaktionen unabhängig von der Einstellung des Knotens für Transaktionsmodus und schreiben ihre Transaktion fest, nachdem die Nachricht verarbeitet wurde.

In der folgenden Tabelle werden die erweiterten Eigenschaften des SOAPInput-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung  
SOAP 1.1-Actor (SOAP 1.2-Aufgabenbereich) Ja Nein Letztendliche Zieladresse (Letztendlicher Empfänger) Mit dieser Eigenschaft können Sie den SOAP-Actor (SOAP 1.1-Protokoll) bzw. die SOAP-Rolle (SOAP 1.2-Protokoll), die vom SOAPInput-Knoten übernommen wird, konfigurieren. Der Standardwert ist Letztendliche Zieladresse (Letztendlicher Empfänger). (Letztendliche Zieladresse bezieht sich auf SOAP 1.1 und Letztendlicher Empfänger auf SOAP 1.2). Sie können jeden beliebigen vordefinierten oder benutzerdefinierten Wert angeben.

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.

Wenn Sie die Option leer auswählen, tritt bei der Datenflussüberprüfung ein Fehler auf.

Für diese Eigenschaft muss ein Zeichenfolgewert angegeben werden.

 
Zieladressenliste festlegen 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, sodass Sie einen RouteToLabel-Knoten nach dem SOAPInput-Knoten im Nachrichtenfluss verwenden können. Bei diesem Eigenschaftentyp handelt es sich um einen Booleschen Wert.  
Zieladressenpräfix Nein Nein Ohne Das Präfix, das bei der Weiterleitung an Zieladressen zum Methodennamen hinzugefügt wird. Fügen Sie ein Präfix hinzu, um Konflikte zwischen den jeweiligen Kennsatzknoten zu vermeiden, wenn Sie mehrere Empfangsknoten in denselben Nachrichtenfluss aufnehmen. Standardmäßig ist kein Kennsatzpräfix vorhanden; der Methodenname und die Kennsatzbezeichnung sind also identisch.

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

 
Fehler bei Eingangsverarbeitung an Fehlerterminal weiterleiten Nein Ja Nicht ausgewählt Aktivieren Sie dieses Kontrollkästchen, wenn bei der Verarbeitung ankommender SOAP-Nachrichten auftretende Fehler an das Fehlerterminal (Failure) gesendet werden sollen. Wenn diese Eigenschaft ausgewählt ist und während der Verarbeitung ankommender SOAP-Nachrichten eine Situation auftritt, die zu einem SOAP-Fehler führt, wird der SOAP-Fehler nicht sofort an den Client zurückgesendet, sondern zur Protokollierung und Wiederherstellung an das Fehlerterminal (Failure) gesendet. In einem solchen Fall wird eine Ausnahmeliste mit der ankommenden Nachricht als BLOB an das Fehlerterminal gesendet. Das Kontrollkästchen ist standardmäßig inaktiviert. sendProcessingFaultsToFailure
WSDL-definierte SOAP-Header Nein Nein   Diese Tabelle ist schreibgeschützt und wird durch die SOAP-Header belegt, die im Ausgabeteil der ausgewählten Operationen definiert sind. Die Tabelle wird bei der Aktualisierung der ausgewählten Operation automatisch aktualisiert. Standardmäßig sind die Kontrollkästchen in der zweiten Tabellenspalte für alle Einträge der Tabelle mit WSDL-Definitionen inaktiviert.

Sie müssen die Kontrollkästchen für die Header, die Sie der Liste must understand headers (Muss Header verstehen) hinzufügen möchten, aktivieren. 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 müssen Sie der Liste must understand headers (Muss Header verstehen) keine Header hinzufügen, da diese Elemente ohnehin erkannt werden, wenn Sie WS-Erweiterungen konfigurieren.

Diese Eigenschaft wird in der CMF-Datei generiert.

Wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert und keine WSDL-Datei erforderlich ist, wird diese Tabelle gelöscht. Die ursprünglichen Werte dieser Felder werden wiederhergestellt, wenn der Betriebsmodus des Knotens wieder in WSDL-Modus geändert wird.

 
Benutzerdefinierte SOAP-Header Nein Ja Ohne In dieser Tabelle können Sie benutzerdefinierte Header hinzufügen. Über die Optionen Hinzufügen, Bearbeiten und Löschen können Sie Zeilen in dieser Tabelle ändern. Sie müssen sicherstellen, dass das Kontrollkästchen für den hinzugefügten, benutzerdefinierten Header (in der zweiten Spalte der Tabelle) aktiviert ist, damit der Header zu der Liste must understand headers (Muss Header verstehen) hinzugefügt wird. Diese Eigenschaft wird in der CMF-Datei generiert.

Wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert und keine WSDL-Datei erforderlich ist, wird für angepasste Header in dieser Tabelle Operation auf * gesetzt. Die ursprünglichen Werte dieser Felder werden wiederhergestellt, wenn der Betriebsmodus des Knotens wieder in WSDL-Modus geändert wird.

 

In der folgenden Tabelle werden die WS-Erweiterungseigenschaften des SOAPInput-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
WS-Adressierung verwenden Nein Nein Nicht ausgewählt Diese Eigenschaft gibt an, ob die WS-Adressierung auf dem SOAPInput-Knoten in Anspruch genommen werden soll. Das Kontrollkästchen ist standardmäßig inaktiviert. Wenn diese Eigenschaft ausgewählt ist, kann eine Antwort an einen anderen Web-Service-Client gesendet werden, als in den WS-Adressierungseigenschaften angegeben ist. Die Antwort kann unter Verwendung eines Transports gesendet werden, der sich von demjenigen für die eingehende Nachricht unterscheidet.
WS-Adressierungsheader in LocalEnviroment ablegen Nein Nein Nicht ausgewählt Diese Eigenschaft gibt an, ob der Knoten WS-Adressierungsheader, die in der Nachricht empfangen wurden, in die Baumstruktur der lokalen Umgebung stellt. WS-Adressierungsheader können vom Nachrichtenfluss nicht aufgerufen werden, wenn dieses Kontrollkästchen inaktiviert ist. Der Grund hierfür ist, dass standardmäßig alle Header verarbeitet und entfernt werden.
WS-Security Nein Ja   Diese komplexe Eigenschaft ist in Form einer Tabelle vorhanden und besteht aus zwei Spalten:
  • Aliasname
  • XPath-Ausdruck
Sie können der Tabelle WS-Sicherheit XPath-Ausdrücke mit zugehörigen Alias-Werten hinzufügen. Der Aliasname wird in einem vom Administrator erstellten Richtliniensatz aufgelöst. Der Richtliniensatz löst den Aliasnamen auf, um den Teil der Nachricht, auf den der XPath-Ausdruck verweist, entweder zu verschlüsseln oder zu signieren. Sie können die Optionen Hinzufügen, Bearbeiten und Löschen in dieser Tabelle verwenden.

In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des SOAPInput-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
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.

Eigenschaften für die Syntaxanalyse der Eingabenachricht werden inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

Nachrichtengruppe Ja Nein Wird automatisch durch die Eigenschaft Name der WSDL-Datei festgelegt. Der Name der Nachrichtengruppe, in der die ankommende Nachricht definiert ist. Dieser Wert wird beim Zuordnen der WSDL-Datei zum Knoten automatisch auf die Nachrichtengruppe gesetzt, die die WSDL-Datei enthält.

Wenn Sie diese Eigenschaft festlegen und die Projektabhängigkeiten später aktualisieren, um diesen Nachrichtengruppenverweis zu entfernen, wird eine Warnung ausgegeben. Aktualisieren Sie entweder die Eigenschaft Nachrichtensatz, oder stellen Sie den Verweis auf dieses Nachrichtensatzprojekt wieder her.

Eigenschaften für die Syntaxanalyse der Eingabenachricht werden inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

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 eingehenden Nachricht. Diese Eigenschaft kann nicht festgelegt werden.

In der folgenden Tabelle werden die Parseroptionseigenschaften des SOAPInput-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
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. Durch den Standardwert Bei Bedarf wird die Syntaxanalyse der Nachricht verzögert.

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

Baumstruktur mithilfe 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.

Diese Eigenschaft wird gelöscht und inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

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 Leer Diese Eigenschaft gibt eine Liste der Elemente der Eingabenachricht an, die nicht transparent analysiert werden sollen. Die nicht transparente Syntaxanalyse wird nur ausgeführt, wenn keine Gültigkeitsprüfung aktiviert ist (das heißt, wenn Auswerten auf Keine gesetzt ist); Einträge, die in Nicht transparente Elemente angegeben sind, werden ignoriert, wenn die Gültigkeitsprüfung aktiviert ist.

In der folgenden Tabelle werden die Validierungseigenschaften des SOAPInput-Knotens beschrieben. Weitere Informationen hierzu finden Sie unter Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswertung Nein Ja Inhalt und Wert Diese Eigenschaft steuert, ob der SOAP-Parser den Hauptteil jeder Eingabenachricht anhand des von der Nachrichtengruppe generierten XML-Schemas überprüft. Gültige Werte sind Keine, Inhalt und Wert und Inhalt. Für die Auswertung des XML-Hauptteils des SOAP-Web-Service ruft der SOAP-Parser den XMLNSC-Parser auf. Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet. Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.

Auswertungseigenschaften werden inaktiviert und die Eigenschaft Auswerten wird auf Ohne gesetzt, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

validateMaster
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.

Auswertungseigenschaften werden inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

 

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

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Pool zusätzlicher Instanzen Nein Ja Pool verwenden, der dem Nachrichtenfluss zugeordnet ist Gibt an, ob zusätzliche Instanzthreads aus einem Thread-Pool für den gesamten Nachrichtenfluss oder für diesen einzelnen Knoten zugeordnet werden.
  • Wenn Sie Pool verwenden, der dem Nachrichtenfluss zugeordnet ist, werden zusätzliche Instanzen aus dem Nachrichtenfluss bereitgestellt.
  • Wenn Sie Dem Knoten zugeordneten Pool verwenden auswählen, werden zusätzliche Instanzen ausgehend von der in der Eigenschaft Zusätzliche Instanzen angegebenen Anzahl zugeordnet.
 
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 bereitgestellt. additionalInstances
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft O K Standardwert Beschreibung
Ereignisse Nein Nein Ohne Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss Überwachungsereignisse definiert. Über Hinzufügen, Bearbeiten und Löschen können Sie Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren).

Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:22


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac56170_