SOAPAsyncRequest-Knoten

Mit dem SOAPAsyncRequest-Knoten können Sie in Verbindung mit dem SOAPAsyncResponse-Knoten ein Nachrichtenflusspaar erstellen, das einen Web-Service asynchron aufruft.

Zweck

Der SOAPAsyncRequest-Knoten sendet eine Web-Service-Anforderung, wartet jedoch nicht auf den Empfang der entsprechenden Web-Service-Antwort. Stattdessen wartet der SOAPAsyncRequest-Knoten vor der Fortführung des Nachrichtenflusses auf die HTTP 202-Bestätigung. Erhält der SOAPAsyncRequest-Knoten diese Bestätigung nicht, blockiert er den Nachrichtenfluss. Die Web-Service-Antwort wird von dem SOAPAsyncResponse-Knoten empfangen, der sich auch in einem separaten Nachrichtenfluss befinden kann. Die Knoten werden als Paar verwendet und stellen eine Korrelation zwischen den Antworten und den ursprünglichen Anforderungen her.

Diagramm zur Veranschaulichung der Beziehung zwischen dem SOAPAsynchronousRequest-Knoten und dem SOAPAsynchronousResponse-Knoten. Auf diese Beziehung wird im Text näher eingegangen.

Der SOAPAsyncRequest-Knoten ist die erste Hälfte des asynchronen Anforderungs- und Antwortknotenpaars. Der SOAPAsyncRequest-Knoten ruft einen fernen SOAP-basierten Web-Service auf. Die Anforderung wird vom SOAPAsyncRequest-Knoten gesendet, der SOAPAsyncRequest-Knoten ist nicht der Empfänger der Antwort. Die Antwort wird von einem SOAPAsyncResponse-Knoten empfangen, der auf einem anderen Thread aktiv ist. Der SOAPAsyncResponse-Knoten befindet sich in der Regel am Anfang eines anderen Nachrichtenflusses. Dieser Nachrichtenfluss muss allerdings der gleichen Ausführungsgruppe angehören wie der SOAPAsyncRequest-Knoten.

Der SOAPAsyncRequest-Knoten ist, ähnlich wie der SOAPRequest-Knoten, WSDL-gesteuert.

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

Symbol für Knoten 'SOAPAsyncRequest'

Diesen Knoten in einem Nachrichtenfluss verwenden

Das folgende Beispiel veranschaulicht die Verwendung der asynchronen SOAP-Knoten für den Aufruf eines Web-Services. Der Web-Service simuliert einen Bestellservice, und der Client zeigt, wie vorhandene WebSphere MQ-Schnittstellen erweitert werden, damit sie Web-Service-Anforderungen ausgeben können.

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

SOAPAsyncRequest-Knoten konfigurieren

Wenn Sie eine Instanz des SOAPAsyncRequest-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn 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. Legen Sie auf der Registerkarte Grundeinstellung die folgenden Eigenschaften fest:
    • Eindeutige ID. Sie müssen das eindeutige URL-Fragment angeben, das Ihr Knotenpaar SOAPAsyncRequest-Knoten und SOAPAsyncResponse-Knoten gemeinsam hat. Diese Eigenschaft muss angegeben werden.
    • Sie müssen diesem Knoten eine WSDL zuordnen und einige WSDL-spezifische Eigenschaften konfigurieren. 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 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 SOAPAsyncRequest-Knoten hinzufügen.
  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. Diese Eigenschaft enthält den Wert der Wartezeit, die verstreicht, bis der ferne Server mit einer Nachrichtenempfangsbestätigung antwortet. Die Zeit in Sekunden, die der Knoten auf eine Antwort vom Web-Service wartet. Der gültige Bereich liegt zwischen 1 und (231)-1. Werte, die eine unbegrenzte Wartedauer angeben, sind nicht zulässig. Der Standardwert lautet 120.
    • HTTP(S)-Proxyadresse. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Geben Sie im Feld HTTP(S)-Proxyadresse die Adresse des Proxy-Servers an, an den Anforderungen gesendet werden. Dieser Wert muss das Format Hostname:Port haben.
    • SSL-Protokoll (bei Verwendung von SSL). Bei diesem Eigenschaftentyp handelt es sich um eine Aufzählung. Geben Sie das SSL-Protokoll an, das für die Anforderung verwendet werden soll. Folgende Optionen stehen zur Verfügung:
      SSL
      Der Standardwert. Bei dieser Option wird zuerst versucht, die Verbindung über das SSLv3-Protokoll herzustellen. Der Handshake kann 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. Der Handshake kann nicht auf SSLv2 zurückgreifen.
      TLS
      Bei dieser Option wird nur versucht, die Verbindung über das TLS-Protokoll herzustellen. Der Handshake kann nicht auf SSLv3 oder SSLv2 zurückgreifen.

      Beide Seiten einer SSL-Verbindung müssen dasselbe Protokoll verwenden. Der ferne Server muss das Protokoll akzeptieren können.

    • 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. In dieser Liste von Chiffrierwerten 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.

    Die in diesem Knoten konfigurierte Eigenschaft must understand headers (Muss Header verstehen) wird auf den entsprechenden SOAPAsyncResponse-Knoten angewendet, wenn der SOAPAsyncResponse-Knoten die Antwort vom fernen Server empfängt.

  5. Konfigurieren Sie auf der Registerkarte WS-Erweiterungen die WS-Erweiterungen. Auf dieser Registerkarte können zwei Konfigurationen eingestellt werden:
    • WS-Adressierung verwenden. Mit dieser Eigenschaft geben Sie an, dass die WS-Adressierung für den SOAPAsyncRequest-Knoten immer aktiviert ist.
    • WS-Sicherheit. 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.

Terminals und Eigenschaften

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

Terminal Description
In Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
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 Die Nachricht, die das Ausgangsterminal verlässt, ist identisch mit der Nachricht, die am Eingabeterminal ankommt. Wenn im Empfangsknoten keine Fehler auftreten, wird eine von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgangsterminal gesandt.

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

Eigenschaft M C Standardwert Description
Eindeutige ID Ja Nein   Geben Sie das eindeutige URL-Fragment an, das Ihr Knotenpaar SOAPAsyncRequest-Knoten und SOAPAsyncResponse-Knoten gemeinsam hat.
Name der WSDL-Datei Ja Nein   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.
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. 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 Nein 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 SOAPAsyncRequest-Knotens beschrieben.

Eigenschaft M C Standardwert Description
Web-Service-URL Ja Nein   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 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.
Zeitlimit für Anforderung (in Sekunden) Nein Nein 120 Bei diesem Eigenschaftentyp handelt es sich um eine ganze Zahl. Diese Eigenschaft enthält den Wert der Wartezeit, die verstreicht, bis der ferne Server mit einer Nachrichtenempfangsbestätigung antwortet.

Die Zeit in Sekunden, die der Knoten auf eine Antwort vom Web-Service wartet. Der gültige Bereich liegt zwischen 1 und (231)-1. Werte, die eine unbegrenzte Wartedauer angeben, sind nicht zulässig.

HTTP(S)-Proxyadresse Nein Nein   Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Die Adresse des Proxy-Servers fest, an den Anforderungen gesendet werden. Dieser Wert muss das Format Hostname:Port haben.
SSL-Protokoll (bei Verwendung von SSL) Nein Nein SSL Bei diesem Eigenschaftentyp handelt es sich um eine Aufzählung. SSL-Protokoll bei der Erstellung einer HTTPS-Anforderung. Gültige Werte sind:
  • SSL
  • SSLv3
  • TLS
Erlaubte SSL-Verschlüsselungen (bei Verwendung von SSL) Nein Nein Leer Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Eine durch Kommas getrennte Liste von Verschlüsselungen, die bei der Erstellung einer SSL-Anforderung verwendet wird. Wenn der Standardwert eine leere Zeichenfolge ist, werden alle verfügbaren Verschlüsselungen verwendet.

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

Eigenschaft M C Standardwert Description
WSDL-definierte SOAP-Header Nein Nein   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.
Benutzerdefinierte SOAP-Header Nein Nein   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.

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

Eigenschaft M C Standardwert Description
WS-Adressierung verwenden Nein Nein Ausgewählt Diese Eigenschaft kann nicht bearbeitet werden. Mit dieser Eigenschaft geben Sie an, dass die WS-Adressierung für den SOAPAsyncRequest-Knoten immer aktiviert ist.
WS-Sicherheit Nein Nein   Diese Tabelle 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.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac56200_