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.

SCAAsyncRequest-Knoten

Mit dem SCAAsyncRequest-Knoten können Sie in Verbindung mit einem SCAAsyncResponse-Knoten ein Nachrichtenflusspaar erstellen, das eine WebSphere Process Server-Servicekomponente asynchron aufruft.

Anmerkung: Ab Version 7.5 hat WebSphere Process Server die Bezeichnung IBM® Business Process Manager Advanced. Informationen zu WebSphere Process Server Version 7.0 in diesem Abschnitt gelten daher auch für IBM Business Process Manager AdvancedVersion 7.5.

Zweck

Der SCAAsyncRequest-Knoten sendet eine Anforderung an einen Geschäftsprozess, der in WebSphere Process Server ausgeführt wird, wartet jedoch nicht auf den Empfang der entsprechenden Antwort. Der SCAAsyncRequest-Knoten wartet jedoch vor der Fortführung des Nachrichtenflusses auf eine Bestätigung. Die Antwort auf die Anforderung des Prozess-Servers wird vom SCAAsyncResponse-Knoten empfangen, der sich in demselben Nachrichtenfluss oder in einem anderen Nachrichtenfluss befinden kann. Die Knoten werden als Paar verwendet und stellen eine Korrelation zwischen den Antworten und den ursprünglichen Anforderungen her.

Diagramm, das die Beziehung zwischen dem SCAAsynchronousRequest- und dem SCAAsynchronousResponse-Knoten veranschaulicht.

Der SCAAsyncRequest-Knoten ist die erste Hälfte des asynchronen Anforderungs- und Antwortknotenpaars. Der SCAAsyncRequest-Knoten sendet eine Anforderung an einen Geschäftsprozess, der auf WebSphere Process Server ausgeführt wird. Die Anforderung wird vom SCAAsyncRequest-Knoten gesendet, der SCAAsyncRequest-Knoten ist nicht der Empfänger der Antwort. Die Antwort wird von einem SCAAsyncResponse-Knoten empfangen, der auf einem anderen Thread aktiv ist. Der SCAAsyncResponse-Knoten befindet sich in der Regel am Anfang eines anderen Nachrichtenflusses. Dieser Nachrichtenfluss muss allerdings der gleichen Ausführungsgruppe angehören wie der SCAAsyncRequest-Knoten.

Sowohl für die Konfiguration des SCAAsyncRequest-Knotens als auch des SCAAsyncResponse-Knotens ist eine Broker-SCA-Definition erforderlich. Die Broker-SCA-Definition enthält spezielle Daten im Zusammenhang mit der Bindung des Prozess-Servers.

Der SCAAsyncRequest-Knoten befindet sich im Ablagefach SCA der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für SCAAsyncRequest-Knoten

Verwendung dieses Knotens in einem Nachrichtenfluss

Das folgende Beispiel zeigt, wie der 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.

Sie können die aufzurufende Operation ändern, indem Sie den Wert an folgender Position in der lokalen Umgebung ändern:

LocalEnvironment.Destination.SCA.Request.Operation

Bei einer Web-Service-Bindung können Sie die URL ändern, an welche die Anforderung gesendet wird. Ändern Sie den Wert an folgender Position in der lokalen Umgebung:

LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.WebServiceURL

Bei einer MQ-Bindung können Sie den Anforderungs-WS-Manager und die Anforderungswarteschlange durch Änderung der Werte an folgenden Positionen ändern:

LocalEnvironment.Destination.SCA.Request.Binding.MQ.queueManagerName
LocalEnvironment.Destination.SCA.Request.Binding.MQ.queueName

Sie können Kontextdaten an der folgenden Position in der lokalen Umgebung speichern. Diese Daten können später vom SCAAysncResponse-Knoten abgerufen werden.

LocalEnvironment.Destination.SCA.Request.UserContext
Den Schlüsselaliasname für die SSL-Authentifizierung können Sie ändern, indem Sie den Wert in der lokalen Umgebung an der folgenden Stelle ändern:
LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.KeyAlias

Den SCAAsyncRequest-Knoten konfigurieren

Vergewissern Sie sich, dass die Nachrichtengruppe eine Broker-SCA-Definition mit der Erweiterung '.outsca' enthält, über die der SCAAsyncRequest-Knoten konfiguriert wird.

Sie haben zwei Möglichkeiten, um eine Instanz des SCAAsyncRequest-Knotens in einen Nachrichtenfluss zu stellen: Sie können entweder eine Instanz des Knotens aus der Knotenpalette ziehen oder eine Broker-SCA-Definition mit der Erweiterung 'outsca' aus einer Nachrichtengruppe auf den Erstellungsbereich des Nachrichtenflusseditors ziehen.

Knoten in den Erstellungsbereich ziehen
Wenn Sie eine Instanz des Knotens aus der Palette in den Erstellungsbereich gezogen haben, führen Sie zu dessen Konfiguration eine der folgenden Methoden aus:
  • Ziehen Sie eine Broker-SCA-Definition mit der Erweiterung .outsca auf den Knoten.
  • Geben Sie in der Ansicht 'Eigenschaften' des Knotens unter SCA file name (SCA-Dateiname) den Dateinamen der Broker-SCA-Definition ein.
  • Suchen Sie nach der Datei (Option SCA file name (SCA-Dateiname) in der Ansicht 'Eigenschaften' des Knotens).
.outsca-Datei in den Erstellungsbereich ziehen
  • Wenn die .outsca-Datei eine WSDL enthält, die nur eine einzige, unidirektionale Operation definiert, wird der SCARequest-Knoten erstellt.
  • Wenn die .outsca-Datei eine WSDL enthält, die nur Anforderungs-/Antwortoperationen enthält, müssen Sie die Operation auswählen und angeben, ob die abgehende Anforderung synchron oder asynchron gesendet werden soll. Bei einer synchronen Anforderung wird der SCARequest-Knoten erstellt und konfiguriert. Bei einer asynchronen Anforderung wird das Knotenpaar SCAAsyncRequest und SCAAsyncResponse erstellt und konfiguriert.
  • Wenn die .outsca-Datei eine WSDL mit einer Mischung aus unidirektionalen und Anforderungs-/Antwortoperationen enthält und Sie eine unidirektionale Operation auswählen, wird ein SCARequest-Knoten erstellt.

In der Broker-SCA-Definition werden Werte für viele der Knoteneigenschaften bereitgestellt. 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 Eigenschaften Eindeutige Kennung und Broker-SCA-Definition fest.
    • Eindeutige ID. Sie müssen die eindeutige Zeichenfolge angeben, die Ihr Knotenpaar aus SCAAsyncRequest-Knoten und SCAAsyncResponse-Knoten gemeinsam hat. Diese Eigenschaft muss angegeben werden.
    • Geben Sie unter Broker-SCA-Definition den Namen der Broker-SCA-Definition an, die Konfigurationseigenschaften für den SCAAsyncRequest-Knoten enthält. Wenn Sie den Knoten durch Ziehen einer Broker-SCA-Definition aus einer Nachrichtengruppe auf den Erstellungsbereich des Nachrichtenflusseditors erstellt haben, ist diese Eigenschaft auf den Namen der Broker-SCA-Definition voreingestellt. Wenn Sie den Knoten durch seine Auswahl aus der Palette erstellt haben, können Sie diese Eigenschaft auf eine der folgenden Arten festlegen:
      • Wenn Sie über eine Broker-SCA-Definition verfügen, können Sie diese durch einen Klick auf Durchsuchen in den verfügbaren Broker-SCA-Definitionen auswählen.
      • Geben Sie einen Dateinamen relativ zu dem Nachrichtengruppenprojekt ein, in dem sich die Broker-SCA-Definition befindet.
      • Wenn Ihnen zwar Broker-SCA-Definitionen zur Verfügung stehen, Sie jedoch über keine Nachrichtengruppe verfügen, können Sie wie folgt eine Nachrichtengruppe erstellen:
        1. Klicken Sie auf Durchsuchen, um das Fenster Broker-SCA-Definition - Auswahl zu öffnen.
        2. Klicken Sie auf Importieren/Neu erstellen, um den Assistenten Broker-SCA-Definition importieren aufzurufen.
        3. Geben Sie den Namen der Nachrichtengruppe und den des Nachrichtengruppenprojekts ein und klicken Sie dann auf Weiter.
        4. Wählen Sie eine der folgenden Optionen aus:
          • Wenn Ihre Broker-SCA-Definition im Arbeitsbereich vorhanden ist, klicken Sie auf Ressourcen aus dem Arbeitsbereich verwenden und wählen Sie dann die Broker-SCA-Definition aus.
          • Wenn die Broker-SCA-Definition im lokalen Dateisystem abgelegt ist, klicken Sie auf Externe Ressourcen verwenden, wählen Sie die Broker-SCA-Definition aus und klicken Sie auf Weiter.
        5. Wählen Sie die zu importierende Broker-SCA-Definition aus.
        6. Klicken Sie auf Finish (Fertigstellen). Ein neues Nachrichtengruppenprojekt und eine Nachrichtengruppe werden mit Nachrichtendefinitionen erstellt. Die Broker-SCA-Definition wird dem Ordner mit den Broker-SCA-Definitionen hinzugefügt.
        7. Wählen Sie die Broker-SCA-Definition im Fenster Broker-SCA-Definition - Auswahl aus und klicken Sie dann auf OK.
      • Wenn Ihnen zwar eine Nachrichtengruppe, aber keine Broker-SCA-Definition zur Verfügung steht, generieren Sie eine Broker-SCA-Definition nach den Anweisungen im Abschnitt Nachrichtengruppen: Broker-SCA-Definition auf Basis einer Nachrichtengruppe generieren.
      • Ziehen Sie eine Broker-SCA-Definition aus einer Nachrichtengruppe per Drag-and-Drop auf den Knoten.
  3. Geben Sie auf der Registerkarte Bindung Eigenschaften an, die sich auf die WebSphere Process Server-Bindung beziehen. Einige der Eigenschaften auf dieser Registerkarte sind von der Broker-SCA-Definition abgeleitet.
    • Der Wert der Bindungstyp-Eigenschaft ist von den Binding-Informationen in der Broker-SCA-Definition abgeleitet. Er ist schreibgeschützt. Mögliche Werte:
      • WebService. Anforderungen aus WebSphere Process Server werden als SOAP-Nachrichten über den HTTP-Transport gesendet. In der Tabelle des Abschnitts Terminals und Eigenschaften mit WSDL-Eigenschaften finden Sie ausführliche Informationen zu Bindungseigenschaften, die entweder von der Broker-SCA-Definition bereitgestellt werden oder die Sie festlegen müssen.
      • MQ. Die Anforderungen aus WebSphere Process Server gehen als WebSphere MQ-Nachrichten ein. In den unten stehenden Tabellen mit MQ-Eigenschaften und den Eigenschaften zur Transaktionalität in Terminals und Eigenschaften finden Sie ausführliche Informationen zu Bindungseigenschaften, die entweder von der Broker-SCA-Definition bereitgestellt werden oder die Sie festlegen müssen.

Informationen zum Konfigurieren des SCAAsyncRequests für SSL finden Sie im Abschnitt PKI-Infrastruktur konfigurieren. Darüber hinaus sollten Sie die Informationen zum SOAPAsyncRequest lesen.

Terminals und Eigenschaften

In der folgenden Tabelle werden die SCAAsyncRequest-Knotenterminals beschrieben .

Terminal Beschreibung
Eingangsterminal (In) Das Eingangsterminal, das eine Nachricht annimmt.
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Eingabenachricht gesendet wird, wenn im Knoten ein Fehler auftritt.
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die Nachricht vom Knoten erfolgreich an die SCA-Ressource gesendet wurde.

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

In der folgenden Tabelle werden die Beschreibungseigenschaften des SCAAsyncRequest-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 Basiseigenschaften des SCAAsyncRequest-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Eindeutige ID Ja Ja Nicht festgelegt Die Eigenschaft gibt eine eindeutige Kennung an, die Ihr Knotenpaar aus SCAAsyncRequest-Knoten und SCAAsyncResponse-Knoten gemeinsam hat.
Broker-SCA-Definition Ja Ja Nicht festgelegt Die Eigenschaft gibt den Namen der Broker-SCA-Definition an, die Konfigurationseigenschaften für den SCAAsyncRequest-Knoten enthält. Wenn Sie auf 'Durchsuchen' klicken, wird eine Liste aller relevanten Broker-SCA-Definitionen im aktuellen Arbeitsbereich angezeigt.

In der folgenden Tabelle wird die Bindungseigenschaft des SCAAsyncRequest-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Bindungstyp Ja Nein Aus SCA-Export Diese Eigenschaft ist schreibgeschützt. Sie wird vom Toolkit bei der Syntaxanalyse der SCA-Exportkonfigurationsdatei bereitgestellt. Die Eigenschaft beschreibt den Bindungstyp, der in der Broker-SCA-Definition gefunden wurde. Bei der Bindung 'Web-Services' werden nur die WSDL-Eigenschaften angezeigt. Bei der Bindung 'MQ' werden nur die MQ-Eigenschaften angezeigt.

In der folgenden Tabelle werden die WSDL-Eigenschaften beschrieben. Diese Eigenschaften werden nur beim Bindungstyp 'Web-Services' angezeigt.

Anmerkung: Die Werte für die Eigenschaften müssen auf dem Knoten bereitgestellt werden. Sie sind auf dem Knoten nicht als 'obligatorisch' gekennzeichnet, da die Broker-SCA-Definition möglicherweise nicht alle Eigenschaftswerte enthält, was zur Anzeige von Knotenfehlern führen könnte. Sie müssen für die Eigenschaften, die nicht über die Broker-SCA-Definitionsdatei konfiguriert werden, Werte angeben.
Eigenschaft O K Standardwert Beschreibung
Name der WSDL-Datei Ja Nein Nicht festgelegt Der Name der WSDL-Datei wird der WSDL-Datei entnommen, auf die in der Broker-SCA-Definition verwiesen wird.
Zielnamespace Nein Nein Aus Broker-SCA-Definition Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Er wird vom Toolkit bei der Syntaxanalyse der WSDL-Konfigurationsdatei bereitgestellt, auf die in der Broker-SCA-Definition verwiesen wird.
Porttyp Ja Nein Standardmäßig ist dies der Porttyp, auf den in der Broker-SCA-Definition verwiesen wird. Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Diese Eigenschaft ist schreibgeschützt.
Fehlerbedingungen:
  • Der ausgewählte Porttyp enthält nicht mindestens eine Operation.
Importierte Bindung Ja Nein Aus Broker-SCA-Definition Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Er wird vom Toolkit bei der Syntaxanalyse der Web Services Description Language (WSDL) bereitgestellt, auf die in der Broker-SCA-Definition verwiesen wird.
Fehlerbedingungen:
  • Dem Porttyp sind in der WSDL-Datei keine SOAP-Bindungen (mit HTTP-Transport) zugeordnet.
  • Die ausgewählte Bindung verfügt über keine Operationen.
Operation Ja Nein Aus Broker-SCA-Definition Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge.

Die Eigenschaft Operation listet die Operationen auf, die durch den Porttyp definiert sind. Standardmäßig ist die erste bidirektionale Operation in der Liste ausgewählt.

Es werden nur bidirektionale Operationen unterstützt.
Service-Port Ja Nein Aus Broker-SCA-Definition Bei diesem Eigenschaftentyp handelt es sich um eine Zeichenfolge. Er wird vom Toolkit bei der Syntaxanalyse der WSDL-Konfigurationsdatei bereitgestellt.
Fehlerbedingungen:
  • Es gibt keine Ports, die auf die ausgewählte Bindung verweisen.
Web-Service-URL Ja Ja Aus Broker-SCA-Definition 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.
Schlüsselaliasname für die SSL-Clientauthentifizierung Nein Ja "" (leere Zeichenfolge) Die Eigenschaft keyAlias legt den Schlüsselaliasname für die SSL-Authentifizierung für die Clientseite einer SCAAsyncRequest-Verbindung fest. Bei der Standardeinstellung wird automatisch der erste geeignete Schlüssel ausgewählt.

In der folgenden Tabelle werden die MQ-Eigenschaften beschrieben. Diese Eigenschaften werden nur beim Bindungstyp 'MQ' angezeigt.

Anmerkung: Die Werte für die Eigenschaften müssen auf dem Knoten bereitgestellt werden. Sie sind auf dem Knoten nicht als 'obligatorisch' gekennzeichnet, da die Broker-SCA-Definition möglicherweise nicht alle Eigenschaftswerte enthält, was zur Anzeige von Knotenfehlern führen könnte. Für die Eigenschaften, die nicht in der Broker-SCA-Definitionsdatei konfiguriert sind, müssen Sie Werte angeben.
Eigenschaft O K Standardwert Beschreibung
Operation Ja Nein Aus Broker-SCA-Definition Die verfügbaren Operationen, die in der Schnittstelle der Broker-SCA-Definition gefunden werden. Es werden nur bidirektionale Operationen unterstützt.
Warteschlangenname Ja Ja Aus Broker-SCA-Definition Der Name der Warteschlange, die eine Anforderungsnachricht aus WebSphere Message Broker empfängt. Er wird der Broker-SCA-Definition entnommen, kann jedoch direkt im Knoten aktualisiert werden.

Dies kann eine ferne Warteschlange sein; weitere Informationen finden Sie im Abschnitt "How does distributed queuing work?" (Funktionsweise der verteilten Steuerung von Warteschlangen) im Handbuch Intercommunication des Information Center vonWebSphere MQ.

Name des Warteschlangenmanagers Ja Ja Aus Broker-SCA-Definition Der Name des WS-Managers, der eine Nachricht aus WebSphere Message Broker empfängt. Dieser Name wird der Broker-SCA-Definition entnommen, kann jedoch direkt im Knoten aktualisiert werden.

Wenn Sie eine ferne Warteschlange verwenden, lassen Sie diese Eigenschaft leer, damit WebSphere MQ den Namen des WS-Managers auflösen kann.

Name der Warteschlange für Antwortnachrichten Ja Ja Aus Broker-SCA-Definition Der Name der Warteschlange, die eine Antwortnachricht aus WebSphere Process Server empfängt. Dieser Name wird der Broker-SCA-Definition entnommen, kann jedoch direkt im Knoten aktualisiert werden.
WS-Manager für Antwortnachrichten Nein Ja Aus Broker-SCA-Definition Der Name des WS-Managers, der eine Antwort aus WebSphere Process Server empfängt. Dieser Name wird der Broker-SCA-Definition entnommen, kann jedoch direkt im Knoten aktualisiert werden.

Dieser WS-Manager muss für den Broker als lokal definiert sein.

Korrelation für Antwortnachricht Ja Nein Aus Broker-SCA-Definition Diese Eigenschaft gibt an, wie WebSphere Process Server Korrelations-ID-Informationen in der Antwortnachricht bereitstellt. Mithilfe dieser Korrelationsinformationen ermittelt der WebSphere Message Broker, welche Antwortnachricht zu welcher Anforderung gehört. Die Informationen werden vom Toolkit bei der Syntaxanalyse der SCA-Exportkonfigurationsdatei bereitgestellt.

Wählen Sie 'Aus Nachrichten-ID' aus, wenn der WebSphere Process Server das MQMD-Feld MSGID in der Anforderung in das MQMD-Feld CORRELID in der Antwort kopieren soll.

Wählen Sie 'Aus Korrelations-ID' aus, wenn der WebSphere Process Server das MQMD-Feld CORRELID in der Anforderung in das MQMD-Feld CORRELID in der Antwort kopieren soll.

In der folgenden Tabelle wird die Transaktionalitätseigenschaft des SCAAsyncRequest-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Transaktionsmodus Nein Nein Bei MQ 'yes' (ja) Zur Auswahl für diese Eigenschaft stehen 'automatic' (automatisch), 'no' (nein) oder 'yes' (ja). Die Eigenschaft ist nur aktiviert, wenn der Bindungstyp 'MQ' lautet.
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.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:35


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac68530_