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.

SOAPRequest-Knoten

Mit dem SOAPRequest-Knoten können Sie eine SOAP-Anforderung an den fernen Web-Service senden.

Zweck

Bei dem SOAPRequest-Knoten handelt es sich um einen synchronen Anforderungs- und Antwortknoten, der nach dem Senden der Anforderung so lange blockiert, bis die Antwort empfangen wird. Dieser Knoten aktiviert standardmäßig die HTTP 1.1-Methode 'Keep-Alive'.

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

Symbol für SOAP-Anforderungsknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Der SOAPRequest-Knoten kann in jedem Nachrichtenfluss verwendet werden, der einen Web-Service aufrufen muss. Das folgende Beispiel zeigt, wie dieser Knoten verwendet wird:

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.

Für abgehende SOAP-Anforderungen können Sie Reliable Messaging aktivieren. Dazu müssten Sie einen SOAPRequest-Knoten mit einem für WS-RM konfigurierten Richtliniensatz verknüpfen. Weitere Informationen hierzu finden Sie unter Web Services Reliable Messaging.

Terminals und Eigenschaften

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

Terminal Beschreibung
Eingabeterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Fehlerterminal (Failure) 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 auch Fehler, die dadurch verursacht werden, dass die Wiederholungsverarbeitung stattfindet, bevor die Nachricht durch die Wiederholung an den Ausgangsfluss weitergeleitet wurde.
Ausgang Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn die SOAP-Anforderung erfolgreich gesendet und beantwortet wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist. Wenn keine Fehler im SOAPRequest-Knoten auftreten und von der externen Ressource eine SOAP-Antwort ohne Fehlernachricht empfangen wird, wird sie immer zuerst an das Ausgabeterminal gesendet.
Fehler SOAP-Fehlernachrichten, die als Antwort auf die gesendete Anforderung empfangen werden, werden an das Fehlerterminal weitergeleitet. Falls keine Verbindung zum Fehlerterminal besteht, findet für eine in diesem Nachrichtenfluss empfangene Fehlernachricht keine weitere Verarbeitung statt.

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

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

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Knotentyp 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 SOAPRequest-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Betriebsmodus Ja Ja Einen bestimmten über eine WSDL-Schnittstelle definierten Web-Service aufrufen

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.

Einen bestimmten über eine WSDL-Schnittstelle definierten Web-Service aufrufen
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.
Generischen Web-Service aufrufen
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 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 werden alle Porttypen aufgeführt, die in der mit der Eigenschaft Name der WSDL-Datei festgelegten WSDL-Datei definiert sind.
Fehlerbedingungen:
  • Der ausgewählte Porttyp enthält nicht mindestens eine Operation.

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

Importierte Bindung Ja Nein   Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge.

Diese Eigenschaft wird bei jeder Änderung des Werts Porttyp aktualisiert. In diesem Feld werden alle dem ausgewählten Porttyp zugeordneten importierten SOAP-Bindungen mit HTTP- bzw. JMS-Transport aufgeführt. Wenn Sie eine Bindung auswählen, wird die Registerkarte mit den Eigenschaften des zugehörigen Transports aktiviert; andernfalls ist sie inaktiviert.

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:
  • Dem Porttyp sind in der WSDL-Datei keine 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.

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. Diese Eigenschaft wird bei jeder Änderung des Bindungswerts aktualisiert.

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

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 werden alle WSDL-Ports aufgeführt, 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:
  • 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   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.

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; 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 SOAPRequest-Knotens beschrieben. Diese Einstellungen werden nur verwendet, wenn der Knoten den HTTP-Transport verwendet.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Web-Service-URL Ja Ja SOAP-Adresse des ausgewählten Ports Die URL der ausgewählten SOAP-Adresse. 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:
  • http://<Hostname> muss angegeben werden.
  • Der Standardwert für <Port> ist '80'. Wenn Sie einen Wert angeben, muss vor der Portnummer ein Doppelpunkt (:) stehen.
  • Der Standardwert für <Pfad> ist /. Wenn Sie einen Wert angeben, müssen Sie den Pfad mit dem Zeichen / einleiten.

Sie finden ausführliche Informationen zur Überschreibung dieser Eigenschaft im Abschnitt Standard-URL für einen SOAPRequest-Knoten oder eine Anforderung des SOAPAsyncRequest-Knotens ändern.

webServiceURL
Anforderungszeitlimit (in Sekunden) Nein Ja 120 Die Zeit in Sekunden, die der Client auf die Antwort eines fernen Servers mit der Bestätigung 'Nachricht empfangen' wartet. Das Zeitlimit kann unter Umständen eine Sekunde länger dauern als der angegebene Wert.

Wenn innerhalb dieser Zeit keine Antwort empfangen wird, wird eine SOAP-Fehlerausnahme ausgelöst und an das Fehlerterminal übergeben.

 
HTTP(S)-Proxyadresse Nein Ja Leer Die Adresse des Proxy-Server, an den Anforderungen gesendet werden. httpProxyLocation
Protokoll (bei Verwendung von SSL) Nein Ja TLS Das ausgewählte Protokoll, wenn Sie SSL verwenden. Bei diesem Eigenschaftentyp handelt es sich um eine Aufzählung. Folgende Optionen stehen zur Verfügung:
SSL
Bei dieser Option wird zuerst versucht, die Verbindung über das SSLv3-Protokoll herzustellen. Sie erlaubt dem Handshake jedoch, auf das SSLv2-Protokoll zurückzugreifen, das von dem zugrunde liegenden JSSE-Provider unterstützt wird.
SSLv3
Bei dieser Option wird nur versucht, die Verbindung über das SSLv3-Protokoll herzustellen. Das Zurückgreifen auf SSLv2 ist nicht zulässig.
TLS
Der Standardwert.Bei dieser Option wird nur versucht, die Verbindung über das TLS-Protokoll herzustellen. Das Zurückgreifen auf SSLv3 oder SSLv2 ist nicht zulässig.

Beide Seiten einer SSL-Verbindung müssen sich auf das zu verwendende Protokoll einigen, d. h., das ausgewählte Protokoll muss ein Protokoll sein, das der ferne Server akzeptieren kann.

sslProtocol
Erlaubte SSL-Verschlüsselungen (bei Verwendung von SSL) Nein Ja Ohne Die spezielle SSL-Verschlüsselung oder -Verschlüsselungen, die Sie verwenden. Diese Einstellung ermöglicht es Ihnen, einen einzelnen Chiffrierwert (z. B. SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA) oder eine Liste von Chiffrierwerten anzugeben, die als die einzigen Chiffrierwerte für diese Verbindung verwendet werden. Es muss dabei mindestens ein Chiffrierwert vorhanden sein, der vom fernen Server akzeptiert wird.

Sie können eine Liste mit Chiffrierwerten in einer Prioritätenfolge angeben. Der Server wählt den ersten zulässigen Chiffrierwert in der Liste aus. Wenn keiner der Chiffrierwerte in der Liste geeignet ist, gibt der Server einen Handshakefehler zurück und schließt die Verbindung.

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.

allowedSSLCiphers
Use compression (Komprimierung verwenden) Nein Nein Ohne Diese Eigenschaft bestimmt, ob der Inhalt der HTTP-Anforderung komprimiert wird. Gültige Werte sind "Keine", "gzip", "zlib (deflate)" (zlib (komprimiert)) und "deflate" (komprimiert). Wenn die Anforderung komprimiert wird, wird der Content-Encoding-Header gesetzt. Dieser weist darauf hin, dass der Inhalt komprimiert ist.

In "zlib (deflate)" (zlib (komprimiert)) sind RFC 1950 + RFC 1951 zusammengefasst.

"deflate" (komprimiert) umfasst nur RFC 1951.

requestCompressionType
Accept compressed responses by default (Standardmäßig komprimierte Antworten akzeptieren) Nein Ja Nicht ausgewählt Diese Eigenschaft bestimmt, ob auf die Anforderung komprimierte Antworten akzeptiert werden. Wenn diese Option ausgewählt ist, kann die Anforderung auch Antworten mit der Inhaltscodierung "gzip" oder "deflate" (komprimiert) empfangen. Beim Empfang einer solchen Antwort wird der Inhalt entschlüsselt und der Content-Encoding-Header entfernt.

Wenn der Anforderungsheader noch keinen Accept-Encoding-Header enthält, wird der Accept-Encoding-Header durch Auswahl dieser Option auf "gzip, deflate" (gzip, komprimiert) gesetzt.

acceptCompressedResponses
Perform hostname checking (if using SSL) (Hostnamensprüfung durchführen; bei Verwendung von SSL) Nein Ja Nein Diese Eigenschaft gibt an, ob der Hostname des Servers, der die Anforderung empfängt, mit dem Hostnamen im SSL-Zertifikat übereinstimmen muss. hostnameChecking
Schlüsselaliasname für die SSL-Clientauthentifizierung Nein Ja "" (leere Zeichenfolge) Diese Eigenschaft legt den SSL-Authentifizierungsalias für die Clientseite einer SOAP-Verbindung fest. Bei der Standardeinstellung wird automatisch der erste geeignete Schlüssel ausgewählt. keyAlias

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

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Ziel Ja Ja Ohne Das Ziel, an das der Knoten abgehende Nachrichten sendet. Wenn der SOAPRequest-Knoten zum Senden von Punkt-zu-Punkt-Nachrichten verwendet werden soll, geben Sie als JMS-Warteschlangenname den Namen der Zielwarteschlange ein, der in der JMS-Bindungsdatei aufgelistet ist.

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 einer W3C-URI wird Ziel auf den Wert von destinationName der WSDL gesetzt, bei einer IBM URI auf den Wert von destination.

jmsDestination
Zieladresse für Antworten Nein Ja Ohne Der Name der JMS-Zieladresse, an die die empfangende Anwendung eine Antwortnachricht senden muss. Bei einer unidirektionalen JMS-Operation wird diese Eigenschaft nicht verwendet. Der JMS-Bestimmungsname muss der Domäne des vom empfangenden Client verwendeten JMS-Providers bekannt sein, damit eine Antwortnachricht an diese JMS-Zieladresse zurückgegeben werden kann. Wenn Sie keine Zieladresse für Antworten angeben, wird eine temporäre dynamische Warteschlange als Zieladresse verwendet. Falls Sie die Zieladresse nicht angeben und den JMS-Provider von WebSphere MQ verwenden, müssen Sie temporäre dynamische JMS-Warteschlangen konfigurieren. Informationen zur Konfiguration von temporären dynamischen JMS-Warteschlangen finden Sie im Abschnitt Für den JMS-Provider von WebSphere MQ temporäre dynamische JMS-Warteschlangen konfigurieren.

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 einer W3C-URI wird Zieladresse für Antworten auf den Wert von replyToName der WSDL gesetzt, bei einer IBM URI auf den Wert von replyToName, replyTo, replyToDestination oder replyDestination (je nachdem, welcher Wert zuerst vorkommt). Wenn irgendwelche dieser anderen Eigenschaften vorhanden sind, werden sie in der Tabelle Benutzerparameter als Name-/Wert-Paar angezeigt.

jmsReplyToDestination
Anforderungszeitlimit (in Sekunden) Nein Ja 120 Die Zeit, die der Client auf eine Antwortnachricht eines fernen Servers wartet, bevor es zu einer Zeitlimitüberschreitung kommt. requestTimeout
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. Der Name muss dem Namen eines konfigurierbaren Service entsprechen, der für den Broker, für den Sie den Nachrichtenfluss implementieren, definiert ist.

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.

 
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 die URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM Format definiert ist. Bei einer W3C-URI wird Ausgangskontextfactory auf den Wert von jndiInitialContextFactory der WSDL gesetzt, bei einer 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 SOAPRequest-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 SOAPRequest-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 die URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM Format definiert ist. Bei einer W3C-URI wird Position der JNDI-URL-Bindungen auf den Wert von jndiURL der WSDL gesetzt, bei einer IBM URI auf den Wert von jndiProviderURL.

locationJndiBindings
Verbindungsfactory-Name Ja Ja   Der Name der Verbindungsfactory, der vom SOAPRequest-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. Für 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 die URI im WSDL-Element address im W3C-Standardformat oder im proprietären IBM Format definiert ist. Bei einer W3C-URI wird Verbindungsfactory-Name auf den Wert von jndiConnectionFactoryName der WSDL gesetzt, bei einer IBM URI auf den Wert von connectionFactory.

connectionFactoryName
Benutzerparameter Nein Nein   Diese Tabelle beschreibt die in der Anforderung definierten Benutzereigenschaften. Die Eigenschaften sind Name/Wert-Paare, die in WSDL vorhanden sind, und nicht durch andere Eigenschaften des SOAPRequest-Knotens verwendet werden.  
JNDI-Parameter Nein Nein   Diese Tabelle ordnet JNDI-Kontextparameter ihrem Typ zu.

Diese Eigenschaften erhalten ihre Anfangswerte von den WSDL-Eigenschaften im W3C-Format, beginnend mit jndi-. JNDI-Parameter werden von WSDL im IBM Format nicht unterstützt, die betreffenden Eigenschaften können jedoch auf dem Knoten festgelegt werden.

 

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

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Zielservice Nein Nein Ohne Dieser Service wird vom SOAPRequest-Knoten beim Versenden der Serviceanforderung verwendet.

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

targetService
Zustellmodus Nein Ja Persistent Durch diese Eigenschaft wird der Permanenzmodus gesteuert, den ein JMS-Provider für eine Nachricht verwendet. Folgendes sind gültige Werte:
  • Permanent: Die Nachricht bleibt auch bei einem Systemausfall des JMS-Providers erhalten.
  • Nicht permanent: Die Nachricht geht bei einem Systemausfall des JMS-Providers verloren.

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 einer W3C-URI wird Zustellmodus auf den Wert von deliveryMode der WSDL gesetzt, bei einer IBM URI auf den Wert von deliveryMode oder persistence (je nachdem, welcher Wert zuerst vorkommt). Wenn beide Eigenschaften vorhanden sind, wird die zweite Eigenschaft in der Tabelle Benutzerparameter als Name-/Wert-Paar angezeigt.

deliveryMode
Nachrichtenpriorität Nein Ja 4

Diese Eigenschaft weist der Nachricht eine relative Bedeutung zu und kann von einem empfangenden Web-Service zur Nachrichtenauswahl verwendet werden.

Wählen Sie einen Wert zwischen 0 (niedrigste Priorität) und 9 (höchste Priorität) aus. Der Standardwert lautet 4, was einer mittleren Priorität entspricht. Bei Prioritäten im Bereich 0 - 4 handelt es sich um eine normale Zustellung. Bei Prioritäten im Bereich 5 - 9 erfolgt die Zustellung schneller.

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 einer W3C-URI wird Priorität auf den Wert von priority der WSDL gesetzt, bei einer IBM URI auf den Wert von priority oder Priority (je nachdem, welcher Wert zuerst vorkommt). Wenn beide Eigenschaften vorhanden sind, wird die zweite Eigenschaft in der Tabelle Benutzerparameter als Name-/Wert-Paar angezeigt.

messagePriority
Verfall der Nachricht (ms) Nein Ja 0 Diese Eigenschaft gibt (in Millisekunden) die Zeitdauer an, für die der JMS-Provider die JMS-Ausgabenachricht aufbewahrt. Mit dem Standardwert 0 wird angegeben, dass die Nachricht nicht ablaufen darf.

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

messageExpiration
Nachrichtenart Nein Ja Byte Wählen Sie in der Liste einen Wert aus, um den Typ der JMS-Nachricht zu konfigurieren, der vom SOAPRequest-Knoten erstellt wird. messageType

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

Eigenschaft O K Standardwert Beschreibung
Transaktionsmodus Ja Nein Automatisch

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

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

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.

Wählen Sie Automatisch aus, wenn die Transaktionalität der Nachricht am Anfang des Nachrichtenflusses aus der Einstellung der Eigenschaft Transaktionsmodus des Empfangsknoten übernommen werden soll. Dieser Wert wird nur verwendet, wenn die ausgewählte Operation unidirektional ist.

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

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

Eigenschaft O K Standardwert Beschreibung
WSDL-definierte SOAP-Antwortheader Nein Nein   Diese Tabelle ist schreibgeschützt und wird durch die SOAP-Header belegt, die in dem Ausgabeteil der ausgewählten Operationen definiert sind. Standardmäßig ist die Auswahl der Kontrollkästchen in der zweiten Tabellenspalte für alle Einträge der Tabelle WSDL-definierte SOAP-Antwortheader zurückgenommen. 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.

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 Tabelle wird bei der Aktualisierung der ausgewählten Operation automatisch aktualisiert. 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-Antwortheader Nein Ja Ohne Sie können in dieser Tabelle benutzerdefinierte Headers hinzufügen (d. h. Headers, die nicht in der WSDL-Datei definiert sind). 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. Diese Eigenschaft wird in der CMF-Datei generiert.

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

Eigenschaft O K Standardwert Beschreibung  
WS-Adressierung verwenden Nein Nein   Diese Eigenschaft legt fest, ob die WS-Adressierung verwendet wird.

Sie finden ausführliche Informationen zur WS-Adressierung beim SOAPRequest-Knoten im Abschnitt WS-Adressierung mit dem SOAPRequest-Knoten.

 
WS-Adressierungsheader in LocalEnviroment ablegen Nein Nein Nicht ausgewählt Diese Eigenschaft gibt an, ob der Knoten WS-Adressierungsheader, die in der Antwortnachricht empfangen wurden, in die Baumstruktur der lokalen Umgebung stellt. WS-Adressierungsheader können vom Fluss nicht aufgerufen werden, wenn dieses Kontrollkästchen inaktiviert ist. Der Grund hierfür ist, dass standardmäßig alle Header verarbeitet und entfernt werden.  
MTOM ermöglichen Nein Ja Nein Über diese Eigenschaft wird gesteuert, ob MTOM für den Parser aktiviert ist. Gültige Werte sind Ja, Nein und Übernehmen. Im Abschnitt SOAP MTOM in Verbindung mit den SOAPReply-, SOAPRequest- und SOAPAsyncRequest-Knoten verwenden finden Sie weitere Informationen zur Verwendung von SOAP MTOM mit den SOAPReply-, SOAPRequest- und SOAPAsyncRequest-Knoten.

Die MTOM-Unterstützung wird inaktiviert, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

allowMTOM
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 ist in einem durch den Administrator erstellten Richtliniensatz aufgelöst. Der Richtliniensatz löst den Aliasnamen auf, um den Teil der Nachricht, auf den sich der XPath-Ausdruck bezieht, entweder zu verschlüsseln oder zu signieren. In dieser Tabelle können Sie die Optionen Hinzufügen, Bearbeiten und Löschen verwenden.
 

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

Eigenschaft O K Standardwert Beschreibung
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. Der Abschnitt SOAP-Parser und -Domäne enthält weitere Informationen hierzu.

Die Eigenschaften für die Syntaxanalyse der Antwortnachricht 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 Antwortnachricht definiert ist. Diese Eigenschaft 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 Nachrichtensatzverweis zu entfernen, wird eine Warnung ausgegeben. Aktualisieren Sie entweder die Eigenschaft Nachrichtensatz, oder stellen Sie den Verweis auf dieses Nachrichtensatzprojekt wieder her.

Die Eigenschaften für die Syntaxanalyse der Antwortnachricht werden inaktiviert und diese Eigenschaft wird gelöscht, wenn der Knoten so konfiguriert wird, dass er im Gateway-Modus agiert.

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

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. Die Eigenschaften SOAP-Parser-Optionen bestimmen die Arbeitsweise des SOAP-Parsers. Die SOAP-Parser-Optionen werden an den XMLNSC-Parser weitergeleitet.

Der Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten enthält weitere Informationen hierzu.

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 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 Leer Diese Eigenschaft legt eine Liste der Elemente der Eingabenachricht fest, 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 SOAPRequest-Knotens beschrieben. Diese Eigenschaften gelten nur für die Antwortnachricht; die Anforderungsnachricht wird nicht geprüft.

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 Antwortnachricht anhand des von der Nachricht generierten XML-Schemas überprüfen soll. Gültige Werte sind Keine, Inhalt und Wert und Inhalt. Standardmäßig ist die Gültigkeitsprüfung aktiviert. Für die Auswertung des XML-Hauptteils des SOAP-Web-Service startet der SOAP-Parser den XMLNSC-Parser. 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, Ausnahme und Ausnahmeliste.

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

 
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.

Mit WrittenDestination-Daten arbeiten

Sobald die Anforderung gestellt wurde, wird der WrittenDestination-Ordner der lokalen Umgebung mit der WS-Adressierung (falls verwendet), den Komprimierungsdetails (falls verwendet) und den Transportdetails aktualisiert. Ein WrittenDestination-Eintrag für einen SOAPRequest-Knoten hat das folgende Format, wobei die WS-Adressierungs- und Komprimierungsdetails nur angegeben sind, wenn diese Funktionen genutzt werden, und jmsDestination den Namen Ihres JMS-Ziels bezeichnet:
WrittenDestination = (
   SOAP  = (
      Request = (
         WSA = (
            To = 'URI'
            MessageID = 'id'
            Action = 'doAllTheStuff'
         )
         Transport = (
            HTTP = (
               WebServiceURL = 'http://server:8080/thing'
               Compression   = (
                  OriginalSize   = 775
                  CompressedSize = 411
            )
            JMS = (
               Destination = jmsDestination
            )
         )
      )
   )
)

Überschreibungen der lokalen Umgebung

In der lokalen Umgebung können Sie festgelegte Werte auf die gleiche Weise wie bei anderen Elementen einer Nachricht dynamisch überschreiben. Eine vollständige Liste der Werte, die Sie in der lokalen Umgebung überschreiben können, finden Sie unter Überschreibungen in der lokalen Umgebung.

HTTPRequestHeader

Um den Inhalt eines HTTPRequest-Headers zu steuern, der in einer Nachricht eingeschlossen ist, müssen Sie einen Compute-Knoten einbeziehen, der der Eingabenachricht vor dem HTTPRequest-Knoten im Nachrichtenfluss einen HTTPRequest-Header hinzufügt.

Wird im HTTPInput-Header eine SOAPAction auf eine leere Zeichenfolge gesetzt, wird sie überschrieben, sofern sie nicht explizit im HTTPRequest-Header gesetzt ist; Beispiel:
SET OutputRoot.HTTPRequestHeader.SOAPAction = InputRoot.HTTPInputHeader.SOAPAction
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 | ac56190_