SOAPRequest-Knoten

Mit dem SOAPRequest-Knoten können Sie eine SOAP-Anforderung an den fernen Web-Service senden. Bei dem Knoten handelt es sich um einen synchronen Anforderungs- und Antwortknoten, der blockiert, bis die Antwort eingegangen ist.

Zweck

Der SOAPRequest-Knoten ist im Ablagefach Web-Services der Nachrichtenflussknotenpalette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für SOAP-Anforderungsknotenicon

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:

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

SOAPRequest-Knoten konfigurieren

Nachdem Sie eine Instanz des SOAPRequest-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

  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.
    • Bindungsoperation. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft muss angegeben werden. Im Feld Bindungsoperation werden alle durch die ausgewählte Bindung definierten Operationen aufgeführt. Die erste Operation auf der Liste wird standardmäßig ausgewählt. Diese Eigenschaft wird bei jeder Änderung des Bindungswerts aktualisiert.
    • 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 ausgeblendeten Eigenschaftentyp handelt es sich um eine Zeichenfolge. Zielnamespace ist als Anzeigefeld implementiert. Diese Eigenschaft wird bei der Konfiguration der Eigenschaft Name der WSDL-Datei mit dem Zielnamespace der WSDL-Datei aktualisiert.
  3. Stellen Sie auf der Registerkarte HTTP-Transport die HTTP-Transport-spezifischen Eigenschaften ein:
    • Web-Service-URL. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft ist obligatorisch und 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 er vor der Portnummer einen ':' enthalten.
      • Der Standardwert für <Pfad> ist '/'. Wenn Sie einen Wert angeben, muss er vor dem Pfad ein '/' enthalten.
    • Anforderungszeitlimit (in Sekunden). Bei diesem Eigenschaftentyp handelt es sich um eine ganze Zahl. Dies ist die Wartezeit bis zur Antwort eines fernen Servers mit der Bestätigung 'Empfangene Nachricht'.
    • HTTP(S)-Proxyadresse. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Die Adresse des Proxy-Server, an den Anforderungen gesendet werden.
    • Protokoll (bei Verwendung von SSL). Bei diesem Eigenschaftentyp handelt es sich um eine Aufzählung. Folgende Optionen stehen zur Verfügung:
      SSL
      (Standardwert). 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 zu Grunde 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
      Bei dieser Option wird nur versucht, die Verbindung über das TLS-Protokoll herzustellen. Das Zurückgreifen auf SSLv3 oder SSLv2 ist nicht zulässig.

      Beachten Sie, dass sich beide Seiten einer SSL-Verbindung auf die Verwendung eines Protokolls einigen müssen, damit das ausgewählte Protokoll vom fernen Server akzeptiert werden kann.

    • Erlaubte SSL-Verschlüsselungen (bei Verwendung von SSL) Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. 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.

      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.

  4. Legen Sie auf der Registerkarte Erweitert die Header fest.

    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 Tabelle WSDL-definierte SOAP-Header ist schreibgeschützt und wird auf der Grundlage der SOAP-Header ausgefüllt, die in dem Ausgabeteil der ausgewählten Operationen definiert sind. Standardmäßig sind die Kontrollkästchen in der zweiten Tabellenspalte für alle Einträge der Tabelle WSDL-definierte SOAP-Header 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 (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 benutzerdefinierten 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. Implementieren 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 SOAPRequest-Knoten in Anspruch genommen werden soll.
    • WS-Sicherheit.
    Diese komplexe Eigenschaft wird in Form der Tabelle WS-Sicherheit eingestellt, die aus zwei Spalten besteht:
    • 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. Stellen Sie die Eigenschaften, die die Antwortnachricht betreffen, auf der Registerkarte Syntaxanalyse der Antwortnachricht und der zugehörigen untergeordneten Registerkarte Parser-Optionen ein:
    • Nachrichtendomäne. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Der Wert ist auf SOAP eingestellt; die Eigenschaft kann nicht bearbeitet werden.
    • Nachrichtengruppe. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Die Eigenschaft kann nicht bearbeitet werden, da als Wert der Nachrichtengruppenprojektwert der WSDL-Datei übernommen wird.
    • Nachrichtenart. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Der Wert ist auf Leerzeichen gesetzt; die Eigenschaft kann nicht bearbeitet werden.
    • Nachrichtenformat. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Der Wert ist auf Leerzeichen gesetzt; die Eigenschaft kann nicht bearbeitet werden.
    Untergeordnete Registerkarte Parser-Optionen. 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. Dieser Eigenschaftentyp besteht aus Kontrollkästchen für folgende Eigenschaften:
      • Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen
      • Gemischten Inhalt beibehalten
      • Kommentare beibehalten
      • Verarbeitungsanweisungen beibehalten
    • Nicht transparente Elemente. Mit dieser Eigenschaft können Elemente festgelegt werden, die nicht transparent analysiert werden sollen.
  7. Stellen Sie die für die Validierung notwendigen Eigenschaften auf der Registerkarte Gültigkeitsprüfung ein:
    • 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.

Terminals und Eigenschaften

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

Terminal Description
Fehlerterminal Das Ausgabeterminal, an das eine Nachricht geleitet wird, wenn ein Fehler beim Weitergeben der Nachricht an den Ausgangsfluss festgestellt wird (z. B. ein Fehler bei der Gültigkeitsprüfung einer Nachricht). Zu Fehlern, die an dieses Terminal weitergeleitet werden, gehören diejenigen, die dadurch verursacht werden, dass die Wiederholungsverarbeitung stattfindet, bevor die Wiederholung die Nachricht an den Ausgangsfluss weitergeleitet hat.
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich in die Ausgabewarteschlange eingereiht wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist Wenn im Empfangsknoten keine Fehler auftreten, wird eine von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgangsterminal gesandt.
Catch-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde.

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

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

Eigenschaft M C Standardwert Description
Knotenname Nein Nein Knotentyp Der Name des Knotens.
Kurzbeschreibung Nein Nein None (Keinen) Kurze Beschreibung des Knotens.
Ausführliche Beschreibung Nein Nein None (Keinen) Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.

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

Eigenschaft M C Standardwert Description
Name der WSDL-Datei Ja Nein <Keines> Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Wenn Sie für das Feld Name der WSDL-Datei eine WSDL-Datei auswählen, wird die ausgewählte WSDL überprüft, um sicherzustellen, dass sie WS-I-konform ist. Zur Konfiguration der SOAP-Knoten muss eine implementierbare WSDL-Datei verwendet werden. Nach Auswahl einer gültigen WSDL-Datei wird das Nachrichtengruppenprojekt, zu dem die WSDL-Datei gehört, dem entsprechenden Nachrichtenflussprojekt als Projekt, auf das verwiesen wird, hinzugefügt, sofern der Verweis noch nicht vorhanden ist.
Porttyp Ja Nein Standardmäßig wird der erste in der WSDL-Datei gefundene Porttyp ausgewählt, dem eine HTTP-Bindung zugeordnet ist. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. In dem Feld sind alle Porttypen aufgeführt, die in der mit der Eigenschaft Name der WSDL-Datei festgelegten WSDL-Datei definiert sind.
Fehlerbedingungen:
  • Der ausgewählte Porttyp enthält nicht mindestens eine Operation.
Importierte Bindung Ja Nein   Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge.

Diese Eigenschaft wird bei jeder Änderung des Wertes Porttyp aktualisiert. In diesem Feld sind alle dem ausgewählten Porttyp zugeordneten SOAP-Bindungen mit HTTP-Transport (6.1) aufgeführt. . Bindungen sind in derselben Reihenfolge aufgelistet, in der sie in der WSDL-Datei auftreten. Es wird die Bindung ausgewählt, die sowohl über Ports als auch über Operationen verfügt. Wenn keine derartige Bindung vorhanden ist, wird eine Bindung ausgewählt, die über Ports verfügt. Sind keine Bindungen mit Ports vorhanden, wird die erste Bindung auf der Liste ausgewählt.

Fehlerbedingungen:
  • Dem Porttyp sind in der WSDL-Datei keine SOAP-Bindungen (mit HTTP-Transport) zugeordnet.
  • Die ausgewählte Bindung verfügt über keine Operationen.
Bindungsoperation Ja Nein   Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge.

Das Feld Bindungsoperation enthält alle durch die ausgewählte Bindung definierten Operationen. Die erste Operation auf der Liste wird standardmäßig ausgewählt.

Service-Port Ja Nein   Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Das Portfeld wird bei jeder Aktualisierung der ausgewählten Bindung aktualisiert. In diesem Feld sind alle WSDL-Ports aufgeführt, die auf die ausgewählte Bindung verweisen. Der erste Port für die Bindung ist standardmäßig der ausgewählte Port.
Fehlerbedingungen:
  • Es gibt keine Ports, die auf die ausgewählte Bindung verweisen.
Zielnamespace Ja Nein   Zielnamespace ist als Anzeigefeld implementiert.

Bei diesem ausgeblendeten Eigenschaftentyp handelt es sich um eine Zeichenfolge. Sie wird bei der Konfiguration der Eigenschaft Name der WSDL-Datei mit dem Zielnamespace der WSDL-Datei aktualisiert.

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

Eigenschaft M C Standardwert Description
Web-Service-URL Ja Ja SOAP-Adresse des ausgewählten Ports Die URL der ausgewählten SOAP-Adresse.
Zeitlimit für Anforderung (in Sekunden) Nein Ja 180 Die Zeit, die der Client bis zur Antwort eines fernen Servers mit der Bestätigung 'Empfangene Nachricht' wartet.
HTTP(S)-Proxyadresse Nein Ja   Die Adresse des Proxy-Servers.
Protokoll (bei Verwendung von SSL) Nein Ja SSL Das ausgewählte Protokoll, wenn Sie SSL verwenden
Erlaubte SSL-Verschlüsselungen (bei Verwendung von SSL) Nein Ja None (Keinen) Die spezielle SSL-Verschlüsselung oder -Verschlüsselungen, die Sie verwenden.

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

Eigenschaft M C Standardwert Description
WSDL-definierte SOAP-Header Nein Nein   Diese Tabelle ist schreibgeschützt und wird durch die SOAP-Header belegt, die in dem Ausgabeteil der ausgewählten Operationen definiert sind. Die Tabelle wird bei der Aktualisierung der ausgewählten Operation automatisch aktualisiert. Diese Eigenschaft wird in der CMF-Datei generiert.
Benutzerdefinierte SOAP-Header Nein Ja None (Keinen) In dieser Tabelle können Sie benutzerdefinierte Header hinzufügen. In dieser Tabelle können Sie die Optionen Hinzufügen, Bearbeiten und Löschen verwenden. Diese Eigenschaft wird in der CMF-Datei generiert.

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

Eigenschaft M C Standardwert Description
WS-Adressierung verwenden Nein Nein   Diese Eigenschaft legt fest, ob die WS-Adressierung verwendet wird.
WS Security Nein Ja   Diese komplexe Eigenschaft ist in Form einer Tabelle vorhanden und besteht aus zwei Spalten:
  • 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 M C Standardwert Description
Nachrichtendomäne Nein Nein SOAP Die Domäne für die Syntaxanalyse der Antwortnachricht. Die Nachricht, die vom SOAPInput-Knoten weitergegeben wird, befindet sich standardmäßig in der SOAP-Domäne. Sie können keine andere Domäne angeben.
Nachrichtengruppe Ja Nein Wird automatisch durch die Eigenschaft Name der WSDL-Datei festgelegt. Der Name der Nachrichtengruppe, in der die Antwortnachricht definiert ist.
Nachrichtentyp Nein Nein   Der Name der Antwortnachricht. Der Nachrichtentyp wird vom Knoten automatisch erkannt. Diese Eigenschaft kann nicht festgelegt werden.
Nachrichtenformat Nein Nein   Der Name des physischen Formats der Antwortnachricht. Diese Eigenschaft kann nicht festgelegt werden.

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

Eigenschaft M C Standardwert Description
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Antwortnachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig.

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

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Nachrichtengruppe Durch diese Eigenschaft wird gesteuert, ob die Syntaxelemente in der Nachrichtenbaumstruktur Datentypen aus dem XML-Schema enthalten.
Zugriff auf gemischten Inhalt Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von gemischtem Text in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt.
Kommentare beibehalten Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Kommentaren in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt.
Verarbeitungsanweisung beibehalten Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Verarbeitungsanweisungen in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.
Nicht transparente Elemente Nein Nein   Diese Eigenschaft legt eine Liste der Elemente der Eingabenachricht fest, die nicht transparent analysiert werden sollen. Diese Eigenschaft ist inaktiviert, es sei denn Auswerten ist auf Keine gesetzt.

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

Eigenschaft M C Standardwert Description
Auswertung Nein Ja Inhalt und Wert Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert und Inhalt.
Fehlerbehebungsmaßnahme Nein Ja Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Diese Eigenschaft kann nur angegeben werden, wenn Auswerten auf Inhalt oder Inhalt und Wert gesetzt ist. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahme und Ausnahmeliste.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac56190_