Mit dem SCAAsyncRequest-Knoten können Sie in Verbindung mit einem SCAAsyncResponse-Knoten ein Nachrichtenflusspaar erstellen, das eine WebSphere Process Server-Servicekomponente asynchron aufruft.
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.
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:
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
LocalEnvironment.Destination.SCA.Request.Binding.WebServices.Transport.HTTP.KeyAlias
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.
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.
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.
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.
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:
|
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:
|
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:
|
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:
|
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.
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. |
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. |