SOAPEnvelope-Knoten

Mit dem SOAPEnvelope-Knoten können Sie einer bereits vorhandenen Nachricht eine SOAP-Rahmenanweisung hinzufügen. Dieser Knoten ist für eine Verwendung in Verbindung mit dem SOAPExtract-Knoten ausgelegt.

Dieses Thema enthält folgende Abschnitte:

Zweck

Das Standardverhalten des SOAPEnvelope-Knotens sieht vor, die SOAP-Rahmenanweisung aus einer Standardspeicherposition ($LocalEnvironment/SOAP/Envelope) der Baumstruktur 'Lokale Umgebung' anzuhängen. Sie können mit Hilfe eines XPath-Ausdrucks eine explizite Speicherposition angeben.

Sie können den Knoten auch ohne entsprechenden SOAPExtract-Knoten in einem Datenfluss verwenden; der Knoten verfügt über eine Option zur Erstellung einer Standard-SOAP-Rahmenanweisung.

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

Symbol für Filterknoten

Den SOAPEnvelope-Knoten in einem Nachrichtenfluss verwenden

Dieser Knoten muss in Verbindung mit dem SOAPExtract-Knoten verwendet werden (siehe SOAPExtract-Knoten).

SOAPEnvelope-Knoten konfigurieren

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

  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 Grundeinstellungen:
    1. Geben Sie in der Option Neue Rahmenanweisung erstellen an, ob der Knoten eine SOAP-Rahmenanweisung erstellen oder eine bereits vorhandene verwenden muss. Die Standardeinstellung ist es, eine bereits vorhandene Rahmenanweisung zu verwenden.
    2. Geben Sie in der Option Position einer vorhandenen Rahmenanweisung einen XPath-Ausdruck ein, der für die Adresse steht, aus der der Knoten die SOAP-Rahmenanweisung kopieren soll. Standardmäßig kopiert der Knoten die Rahmenanweisung aus der lokalen Umgebung ($LocalEnvironment/SOAP/Envelope).

Unterstützte Parser

Dieser Knoten ist für den Betrieb mit SOAP-Nachrichten ausgelegt. Verwenden Sie einen der folgenden Parser:
  • SOAP
  • XMLNSC
  • MRM
  • XMLNS
Es werden keine anderen XML-Parser unterstützt, da sie keine Namespaces unterstützen. Beim Empfang einer Nachricht, die nicht den korrekten Parser verwendet oder nicht der Grundstruktur einer SOAP-Nachricht entspricht, wird eine Ausnahmebedingung ausgelöst.

Es wird keine vollständige Auswertung der SOAP-Nachricht durchgeführt; die Nachricht muss lediglich ein Hauptteilelement enthalten.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des SOAPEnvelope-Knotens beschrieben:

Terminal Beschreibung
Eingabeterminal Das Eingabeterminal, das eine SOAP-Nachricht zur Verarbeitung durch einen Knoten annimmt.
Ausgang Das Ausgabeterminal, das die SOAP-Nachricht ausgibt, die aus einem SOAP-Nachrichtenhauptteil und einer SOAP-Rahmenanweisung erstellt wurde.
Fehlerterminal Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn während der Verarbeitung ein Fehler auftritt.

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 SOAPEnvelope-Knotens beschrieben.

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

In der folgenden Tabelle werden die Basiseigenschaften des SOAPEnvelope-Knotens beschrieben.

Eigenschaft M C Standardwert Description
Neue Rahmenanweisung erstellen Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird festgelegt, ob der Knoten eine SOAP-Rahmenanweisung erstellt oder eine bereits vorhandene aus der Nachrichtenbaumstruktur abruft. Wenn Sie das Kontrollkästchen aktivieren, erstellt der Knoten eine neue Rahmenanweisung. Wenn Sie das Kontrollkästchen inaktivieren, kopiert der Knoten die Rahmenanweisung aus dem Wert, der in die Eigenschaft Position einer vorhandenen Rahmenanweisung eingegeben wurde.
Standort bereits vorhandener Rahmenanweisung Nein Nein $LocalEnvironment/SOAP/Envelope Ein XPath-Ausdruck, der für den Standort steht, aus dem der Knoten die Rahmenanweisung kopieren soll. Folgende Korrelationsnamen stehen zur Verfügung:
$Root
Das Stammelement der Nachrichtenbaumstruktur.
$Body
Das letzte untergeordnete Element des Stammverzeichnisses der Nachrichtenbaumstruktur (äquivalent zu /).
$LocalEnvironment
Das Stammelement der Baumstruktur für die lokalen Umgebung.
$Environment
Das Stammverzeichnis der Baumstruktur für die globale Umgebung.

Beispiel für SOAP-Nachrichten

Eingehende SOAP-Rahmenanweisung

<?xml version="1.0"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <tns:requestHeader>
            <tns:assessorUrl>header1</tns:assessorUrl>
        </tns:requestHeader>
    </soapenv:Header>
</soapenv:Envelope>

Eingehender SOAP-Nachrichtenhauptteil

<?xml version="1.0"?>
<tns:requestAvailability
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <tns:carDetails>body1</tns:carDetails>
    <tns:claimID>body2</tns:claimID>
    <tns:location>body3</tns:location>
    <tns:reqDate>body4</tns:reqDate>
</tns:requestAvailability>

Abgehende SOAP-Nachricht

<?xml version="1.0"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <tns:requestHeader>
            <tns:assessorUrl>header1</tns:assessorUrl>
        </tns:requestHeader>
    </soapenv:Header>
    <soapenv:Body>
        <tns:requestAvailability>
            <tns:carDetails>body1</tns:carDetails>
            <tns:claimID>body2</tns:claimID>
            <tns:location>body3</tns:location>
            <tns:reqDate>body4</tns:reqDate>
        </tns:requestAvailability>
    </soapenv:Body>
</soapenv:Envelope>
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac60020_