SOAPInput-Knoten

Verwenden Sie den SOAPInput-Knoten zur Verarbeitung von Client-SOAP-Nachrichten und machen Sie dadurch den Broker zu einem SOAP-Web-Service-Anbieter.

Zweck

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:

Symbol für SOAP-Empfangsknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Der SOAPInput-Knoten kann in jedem Nachrichtenfluss verwendet werden, der SOAP-Nachrichten annehmen muss. Das folgende Beispiel zeigt, wie dieser Knoten verwendet wird:

Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

SOAPInput-Knoten konfigurieren

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.

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine Ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Auf der Registerkarte Grundeinstellung müssen Sie die folgenden WSDL-Eigenschaften festlegen. Sie benötigen zur Konfiguration der WSDL-Datei für diesen Knoten allerdings noch eine Nachrichtengruppe, die die implementierbare WSDL-Datei enthält.
    • Name der WSDL-Datei. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft muss angegeben werden.

      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:

      • Wenn Ihnen implementierbare WSDL-Dateien zur Verfügung stehen, können Sie eine dieser Dateien über die Schaltfläche Durchsuchen auswählen.
      • Wenn Ihnen zwar WSDL-Definitionen, jedoch keine Nachrichtengruppe, zur Verfügung stehen, können Sie wie folgt eine Nachrichtengruppe erstellen:
        1. Klicken Sie auf Durchsuchen, um das Fenster WSDL-Auswahl zu öffnen.
        2. Klicken Sie auf Importieren/Neu erstellen, um den Assistenten WSDL-Datei importieren aufzurufen.
        3. Geben Sie den Namen und den Projektnamen der Nachrichtengruppe ein. Klicken Sie auf Weiter.
        4. Wählen Sie eine der folgenden Optionen aus:
          • Wenn die WSDL-Datei bereits im Arbeitsbereich vorhanden ist, wählen Sie Ressourcen aus dem Arbeitsbereich verwenden und danach die WSDL-Datei aus.
          • Wenn die WSDL-Datei im lokalen Dateisystem abgelegt ist, wählen Sie Externe Ressourcen verwenden und danach die WSDL-Datei aus. Klicken Sie auf Weiter.
        5. Wählen Sie die zu importierenden WSDL-Bindungen aus. Beim Import ausgegebene Warnungen und Fehlernachrichten werden im Assistentenbanner angezeigt.
        6. Klicken Sie auf Fertig stellen. Ein neues Nachrichtengruppenprojekt wird erstellt. Dieses enthält bereits eine Nachrichtengruppe mit Nachrichtendefinitionen. Die WSDL-Definitionen werden dem Ordner mit den implementierbaren WSDL-Dateien hinzugefügt.
        7. Nun können Sie die WSDL-Datei im Fenster WSDL-Auswahl auswählen. Klicken Sie auf OK.
      • Wenn Ihnen eine Nachrichtengruppe zur Verfügung steht, jedoch keine WSDL-Definition, müssen Sie eine WSDL-Definition generieren. Weitere Informationen hierzu finden Sie unter WSDL-Definition aus einer Nachrichtengruppe generieren.
      • Ziehen Sie eine WSDL-Datei aus einer Nachrichtengruppe per Drag-and-Drop auf den Knoten.
      • Geben Sie einen Dateinamen relativ zu dem Nachrichtengruppenprojekt ein, in dem sich die implementierbare WSDL-Datei befindet.

      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.

      Die folgenden Situationen führen in Zusammenhang mit den WSDL-Eigenschaften zu Fehlerbedingungen:
    • Porttyp. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft muss angegeben werden. 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:
      • Der ausgewählte Porttyp enthält nicht mindestens eine Operation.
    • Importierte Bindung. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft muss angegeben werden. 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:
      • Dem Porttyp sind in der WSDL-Datei keine SOAP-Bindungen (mit HTTP-Transport) zugeordnet.
      • Die ausgewählte Bindung verfügt über keine Operationen.
    • Service-Port. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft muss angegeben werden. 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:
      • Es gibt keine Ports, die auf die ausgewählte Bindung verweisen.
    • Zielnamespace. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Im Feld Zielnamespace wird der Namespace der ausgewählten WSDL-Datei angezeigt.
    Beim Speichern der Nachrichtenflussdatei werden einige der WSDL-spezifischen Eigenschaften überprüft. Unter anderem wird geprüft:
    • Ob die WSDL-Datei in der Nachrichtengruppe vorhanden ist.
    • Ob die in der ausgewählten WSDL-Datei definierten Werte der Eigenschaften Porttyp, Bindungsoperation und Service-Port gültig sind.
    Falls eine dieser Bedingungen nicht zutrifft, wird ein Fehler ausgegeben. Sie können der Brokerarchivdatei dann keinen Nachrichtenfluss mit diesem SOAPInput-Knoten hinzufügen.
  3. Stellen Sie auf der Registerkarte HTTP-Transport die folgenden HTTP-Transport-spezifischen Eigenschaften ein. Mit dem Befehl mqsichangeproperties können Sie Portbereiche und Schlüsselspeicher mit der BrokerRegistry-Komponente ändern (siehe mqsichangeproperties-Befehl).
    • URL-Selektor. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft wird automatisch aus dem <soap:address>-Element des ausgewählten Service-Ports abgeleitet. Bei einer Änderung des ausgewählten Ports wird URL-Selektor 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.

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

    • HTTPS verwenden. Auf dieser Registerkarte ist dies eine Boolesche Eigenschaft. Auch diese Eigenschaft wird automatisch aus dem <soap:address>-Element des ausgewählten Service-Ports abgeleitet.

      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.

    • Maximale Wartezeit für Client (Sekunden). Geben Sie das Zeitlimitintervall für die maximale Wartezeit des Clients in Sekunden an. Der SOAPInput-Knoten wird in der Regel in Verbindung mit dem SOAPReply-Knoten verwendet.Diese Eigenschaft gibt die Zeit an, die ein TCP/IP-Empfangsprogramm, das die Eingabenachricht vom Web-Service-Client empfangen hat, auf eine Antwort vom SOAPReplyknoten innerhalb des Nachrichtenflusses wartet. Wenn innerhalb dieser Zeit eine Antwort eingeht, übergibt das Empfangsprogramm die Antwort an den Client. Wenn in dieser Zeit keine Antwort eingeht, sendet das Empfangsprogramm eine SOAP-Fehlernachricht an den Client, in der darauf hingewiesen wird, dass sein Zeitlimit abgelaufen ist.
  4. Legen Sie auf der Registerkarte Erweitert die Header fest:
    • SOAP 1.1-Actor (SOAP 1.2-Aufgabenbereich). Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Mit dieser Eigenschaft können Sie den SOAP-Actor (SOAP 1.1-Protokoll) bzw. die SOAP-Rolle (SOAP 1.2-Protokoll) des SOAPInput-Knotens konfigurieren. Der Standardwert ist Letztendliche Zieladresse (Letztendlicher Empfänger). (Letztendliche Zieladresse bezieht sich auf SOAP 1.1, 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.

      Fehlerbedingungen:
      • Wenn Sie die Option leer auswählen, tritt ein Fehler bei der Datenflussüberprüfung auf.
    • Zieladressenliste festlegen. Bei diesem Eigenschaftentyp handelt es sich um einen Booleschen Wert. Diese Eigenschaft gibt an, ob die eingehende SOAP-Operation zu der Route hinzugefügt werden soll, die in der Zieladressenliste gekennzeichnet werden soll.
    • Zieladressenpräfix. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Dieses Präfix wird dem Namen der Operation in der Zieladressenliste hinzugefügt. Wenn Sie mehrere SOAPInput-Knoten im gleichen Nachrichtenfluss verwenden möchten, müssen Sie ein Zieladressenpräfix hinzufügen, um Konflikte zwischen den zugehörigen Label-Knoten auszuschließen.

      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.

    • 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.
      • Die Headertabelle WSDL-definiert ist schreibgeschützt und wird auf Grundlage der SOAP-Header ausgefüllt, die in den Eingabeabschnitten aller Operationen der ausgewählten Bindung definiert sind. Standardmäßig sind die Kontrollkästchen in der zweiten Tabellenspalte für alle Einträge der Tabelle WSDL-definiert inaktiviert. Sie müssen die Kontrollkästchen der Header, die Sie der Liste must understand headers (Muss Header verstehen) hinzufügen möchten, also explizit aktivieren.
      • Sie können benutzerdefinierte Header, d. h. Header, die nicht in der WSDL-Datei definiert sind, zur Tabelle Benutzerdefinierte SOAP-Header hinzufügen. In dieser Tabelle können Sie Zeilen hinzufügen, bearbeiten und löschen. In der zweiten Tabellenspalte muss das Kontrollkästchen für den neu hinzugefügten Header aktiviert sein, damit der Header zu der Liste must understand headers (Muss Header verstehen) hinzugefügt wird.

      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.

  5. Konfigurieren Sie auf der Registerkarte WS-Erweiterungen die WS-Erweiterungen. Auf dieser Registerkarte können zwei Konfigurationen eingestellt werden:
    • WS-Adressierung verwenden. Diese Eigenschaft gibt an, ob die WS-Adressierung auf dem SOAPInput-Knoten in Anspruch genommen werden soll. Dieses Kontrollkästchen ist standardmäßig aktiviert.
    • Die Tabelle WS-Sicherheit enthält 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.
  6. Die Eigenschaften auf der Registerkarte Syntaxanalyse der Eingabenachricht werden automatisch bei der Konfiguration der WSDL-Datei eingestellt. Diese Werte können nicht geändert werden.
    • Nachrichtendomäne. Dieser Wert ist immer auf "SOAP" gesetzt. Der Abschnitt SOAP-Parser und -Domäne enthält weitere Informationen hierzu.
    • Nachrichtengruppe. Diese Eigenschaft wird beim Zuordnen der WSDL-Datei zum Knoten automatisch auf die Nachrichtengruppe gesetzt, die die WSDL-Datei enthält.
    • Nachrichtenart. Diese Eigenschaft wird nicht verwendet.
    • Nachrichtenformat. Diese Eigenschaft wird nicht verwendet.
  7. Stellen Sie auf der untergeordneten Registerkarte Parser-Optionen die für den Parser notwendigen Eigenschaften ein. Auf dieser Registerkarte sind folgende Eigenschaften aufgelistet:
    • Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt. Dies führt dazu, dass die Syntaxanalyse der Nachricht verzögert wird. Wenn die Syntaxanalyse sofort ausgeführt werden soll, lesen Sie den Abschnitt Bedarfsgerechte Syntaxanalyse.
    • SOAP-Parseroptionen. Legen Sie für die Eigenschaften Werte fest, die die Funktionsweise des SOAP-Parsers bestimmen. Die SOAP-Parser-Optionen werden an den XMLNSC-Parser weitergeleitet. Der Abschnitt Nachrichten in der XMLNS-Domäne bearbeiten enthält weitere Informationen hierzu.
    • Nicht transparente Elemente. Bei diesem Eigenschaftentyp handelt es sich um einen komplexen Wert. Über diese Eigenschaft wird eine Liste von Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser nicht transparent analysiert werden sollen. Weitere Informationen hierzu finden Sie unter XMLNSC-Parser und Nicht transparente XMLNSC-Syntaxanalyse.
  8. Stellen Sie auf der Registerkarte Fehlerbehandlung die für die Fehlerverarbeitung erforderlichen Eigenschaften ein:
    • Während der eingehenden SOAP-Verarbeitung Fehler an das Fehlerterminal senden. Bei diesem Eigenschaftentyp handelt es sich um einen Booleschen Wert. Wenn während der Verarbeitung ankommender SOAP-Nachrichten eine Situation auftritt, die zu einem SOAP-Fehler führt, senden Sie den SOAP-Fehler, statt ihn unmittelbar an den Client zurückzusenden, zur Protokollierung und Wiederherstellung an das Fehlerterminal.

      In einem solchen Fall wird eine Ausnahmeliste mit der ankommenden Nachricht als BLOB an das Fehlerterminal gesandt. Der Standardwert dieser Eigenschaft ist inaktiviert.

  9. Legen Sie auf der Registerkarte Auswertung die Auswertungseigenschaften fest, wenn der SOAP-Parser den Hauptteil jeder Eingabenachricht anhand des von der Nachrichtengruppe generierten XML-Schemas überprüfen soll. Für die Auswertung des XML-Hauptteils des SOAP-Web-Services ruft der SOAP-Parser den XMLNSC-Parser auf. Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.
    • Auswerten. Bei diesem Eigenschaftentyp handelt es sich um eine Aufzählung. Wählen Sie einen der folgenden Werte aus: Keine, Inhalt und Wert oder Inhalt.

      Der Standardwert ist Inhalt und Wert.

    • Aktion bei Fehler. Bei diesem Eigenschaftentyp handelt es sich um eine Aufzählung. Wählen Sie einen der folgenden Werte aus: Benutzertrace, Ausnahmeliste, Lokaler Fehler oder Ausnahme.

    Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.

  10. Auf der Registerkarte Instanzen können Sie folgende Eigenschaften angeben:
    • Pool zusätzlicher Instanzen. Diese Eigenschaft hat die folgenden Werte:
      • Pool verwenden, der dem Nachrichtenfluss zugeordnet ist. Der Standardwert.
      • Pool verwenden, der dem Knoten zugeordnet ist.
    • Zusätzliche Instanzen. Diese Eigenschaft hat den Standardwert0.
  11. Definieren Sie unter Verwendung der Registerkarte Wiederholung, wie Wiederholungsverarbeitung ausgeführt werden soll, wenn ein Fehler zum Empfangsknoten zurückgegeben wird:
    • Wiederholungsmechanismus: Diese Eigenschaft ist eine Aufzählung, die das Format des Mechanismus definiert. Geben Sie entweder den Wert Fehler oder Kurze und lange Wiederholungszeit ein.
    • Wiederholungsschwellenwert: Bei diesem Eigenschaftentyp handelt es sich um eine ganze Zahl, durch die die Anzahl der Wiederholungen zur Korrektur des Fehlers definiert wird.
    • Kurzes Wiederholungsintervall: Bei diesem Eigenschaftentyp handelt es sich um eine ganze Zahl, die die Zeit in Sekunden definiert, die der Client wartet, bevor er versucht, den Fehler zu korrigieren.
    • Langes Wiederholungsintervall: Bei diesem Eigenschaftentyp handelt es sich um eine ganze Zahl, die die Zeit in Sekunden definiert, die der Client wartet, bevor er versucht, den Fehler zu korrigieren.

Terminals und Eigenschaften

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:
  • Der ausgewählte Porttyp enthält nicht mindestens eine Operation.
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:
  • Dem Porttyp sind in der WSDL-Datei keine SOAP-Bindungen (mit HTTP-Transport) zugeordnet.
  • Die ausgewählte Bindung verfügt über keine Operationen.
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:
  • Es gibt keine Ports, die auf die ausgewählte Bindung verweisen.
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:
  • 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 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.
  • Wenn Sie Pool verwenden, der dem Nachrichtenfluss zugeordnet ist, werden zusätzliche Instanzen aus dem Nachrichtenfluss bereitgestellt.
  • Wenn Sie 'Pool verwenden, der dem Knoten zugeordnet ist' auswählen, werden zusätzliche Instanzen des Knotens bereitgestellt, deren Anzahl auf dem Wert basiert, der für die Eigenschaft 'Zusätzliche Instanzen' angegeben wurde.
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.
  • Wenn Sie 'Fehler' auswählen, erfolgt keine Wiederholungsverarbeitung, so dass Sie die übrigen Eigenschaften nicht festlegen können.
  • Wenn Sie Kurze und lange Wiederholungszeit auswählen, erfolgt die Wiederholungsverarbeitung in dem Intervall, das über die Eigenschaft Kurzes Wiederholungsintervall angegeben wurde. Wenn der Vorgang fehlschlägt, erfolgt die Wiederholungsverarbeitung im Intervall, das über die Eigenschaft Langes Wiederholungsintervall angegeben wurde.
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
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac56170_