SAPRequest-Knoten

Mit dem SAPRequest-Knoten können Sie mit einer SAP-Anwendung interagieren.

Dieses Thema enthält folgende Abschnitte:

Zweck

Der SAPRequest-Knoten ermöglicht eine Interaktion mit SAP-Anwendungen. Beispiel: Der SAPRequest-Knoten fordert Informationen von einem unternehmensweiten SAP-Informationssystem an. Ein Kunden-Geschäftsobjektwird an SAP gesendet. Daraufhin ruft SAP Informationen zu einem Kunden wie beispielsweise Adress- und Accountdaten ab. Die Antwortinformationen, die vom SAPRequest-Knoten abgerufen werden, können dann vom übrigen Nachrichtenfluss verwendet werden. Der SAPRequest-Knoten kann Geschäftsdaten senden und empfangen.

Der SAPRequest-Knoten befindet sich im Ablagefach WebSphere Adapters (WebSphere-Adapter) der Nachrichtenflussknotenpalette und wird in Workbench durch folgendes Symbol dargestellt:

Symbol für SAPRequest-Knoten

SAPRequest-Knoten in einem Nachrichtenfluss verwenden

Damit der SAPRequest-Knoten ordnungsgemäß funktioniert, ist eine Adapterkomponente erforderlich, die Sie über die Knoteneigenschaft Adapterkomponente festlegen. Außerdem sind Geschäftsobjekt-Definitionen erforderlich, die in der Nachrichtentengruppe gespeichert sind, auf die vom Knoten aus verwiesen wird. Aus diesem Grund müssen Sie eine Nachrichtengruppe bereitstellen. Die Nachricht, die vom SAPRequest-Knoten weitergegeben wird, befindet sich standardmäßig in der Datenobjektdomäne, daher ist für die Eigenschaft Nachrichtendomäne der Wert 'DataObject' definiert. Sie können keine andere Domäne angeben. Der Nachrichtentyp wird vom Knoten automatisch erkannt.

Der SAPRequest-Knoten unterstützt lokale Transaktionen unter Verwendung des lokalen Transaktionsmanagers des Brokers und globale Transaktionen unter Verwendung des externen Synchronisationspunktkoordinators des Brokers.

Sie können mehrere Anforderungsknoten von WebSphere Adapters, die dieselbe Adapterkomponente verwenden, in einer Ausführungsgruppe implementieren.

Zur Konfiguration eines Accountnamens mit einem Benutzernamen und einem Kennwort für die Adapter for SAP Software können Sie den Befehl mqsisetdbparms im folgenden Format verwenden.
mqsisetdbparms Brokername -n Adaptername -u Benutzername -p Kennwort
Beispiel:
mqsisetdbparms BRK1 -n SAPCustomerOutbound.outadapter -u sapuid -p ********

Anhand des Beispielprogramms Beispielprogramm 'SAP Connectivity' wird die Verwendung dieses Knotens deutlich. Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

SAPRequest-Knoten konfigurieren

Nachdem Sie eine Instanz des SAPRequest-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. (Durch Doppelklicken auf den SAPRequest-Knoten wird der Assistent für die Adapterverbindung geöffnet.)

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

Terminals und Eigenschaften

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

Terminal Beschreibung
Eingangsterminal Das Eingangsterminal, das das AnforderungsGeschäftsobjekt annimmt.
Ausgang Das Ausgabeterminal, an das das Antwort-Geschäftsobjekt gesendet wird, wenn es für einen erfolgreichen Abschluss der Anforderung steht und in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist.
Fehlerterminal Bei einem Fehler im SAPRequest-Knoten wird die Nachricht an das Fehlerterminal weitergegeben. Auch Informationen zum Fehler und den Geschäftsobjekten können an das Fehlerterminal weitergeleitet werden.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen in der Anzeige, 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 SAPRequest-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp, z. B. SAPRequest 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 grundlegenden Eigenschaften des SAPRequest-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Adapterkomponente Ja Nein   Name der Adapterkomponenten mit den Konfigurationseigenschaften für den Adapter. Geben Sie entweder den Namen einer Adapterdatei an, oder klicken Sie auf Durchsuchen, um in der Liste mit den Dateien, die in Referenznachrichtegruppenprojekten verfügbar sind, eine Adapterdatei auszuwählen.
Standardmethode Ja Ja   Die zu verwendende Standardmethodenbindung.
In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Antwortnachricht' des SAPRequest-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein DataObject Die Domäne für die Syntaxanalyse der Antwortnachricht. Die Nachricht, die vom SAPRequest-Knoten weitergegeben wird, befindet sich standardmäßig in der Datenobjektdomäne. Sie können keine andere Domäne angeben.
Nachrichtengruppe Ja Nein Wird automatisch festgelegt. Der Name der Nachrichtengruppe, in der die ankommende Nachricht definiert ist. Dieses Feld wird automatisch anhand der Eigenschaft Adapterkomponente festgelegt.
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 Eigenschaften für die Transaktionalität des SAPRequest-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Transaktionsmodus Nein Nein Automatisch Durch diese Eigenschaft wird gesteuert, wie Aktualisierungen gehandhabt werden.
  • Wenn Sie Ja auswählen, nimmt derSAPRequest-Knoten an der lokalen Transaktion teil, die durch den Empfangsknoten des Nachrichtenflusses gestartet wurde.
  • Wenn Sie Nein auswählen, nimmt der SAPRequest-Knoten nicht an der lokalen Transaktion teil, die durch den Empfangsknoten des Nachrichtenflusses gestartet wurde.
  • Wenn Sie Automatisch auswählen, übernimmt der SAPRequest-Knoten den Wert des Empfangsknotens, der den Nachrichtenfluss steuert. Wird der Nachrichtenfluss beispielsweise durch einen SAPInput-Knoten gesteuert, übernimmt SAPRequest den für den SAPInput-Knoten eingestellten Transaktionsmodus.
In der folgenden Tabelle werden die Anforderungseigenschaften des SAPRequest-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Methodenposition Ja Nein $LocalEnvironment/Adapter/MethodName Die Geschäftsmethode, die verwendet wird, um die Ausführung einer Aktion auf dem externen System durch den SAPRequest-Knoten auszulösen. Beispiel:
  • Mit 'createPurchaseOrder' wird der SAPRequest Knoten dazu veranlasst, einen Auftrag im EIS zu erstellen.
  • Mit 'deletePurchaseOrder' wird der SAPRequest Knoten dazu veranlasst, einen Auftrag im EIS zu löschen.
Datenposition Ja Nein $Body Die Position innerhalb der Baumstruktur für eingehende Nachrichten, aus der Daten für die Anforderung abgerufen werden, die vom SAPRequest-Knoten an das EIS gesendet werden.
In der folgenden Tabelle werden die Ergebniseigenschaften des SAPRequest-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Position für Ausgabedaten Nein Nein $OutputRoot Die Position in der Nachrichtenbaumstruktur, an die der SAPRequest-Knoten Ausgabedaten sendet.
Lokale Umgebung kopieren Nein Nein Ausgewählt Durch diese Eigenschaft wird gesteuert, wie die lokale Umgebung in die Ausgabenachricht kopiert wird. Wenn Sie dieses Kontrollkästchen aktivieren, wird in der Baumstruktur an jedem Knoten des Nachrichtenflusses eine neue Kopie der lokalen Umgebung erstellt. In diese Kopien wird jeweils der Inhalt der lokalen Umgebung des vorangegangenen Knotens eingetragen. Falls also die lokale Umgebung in einem Knoten geändert wird, können die vorgelagerten Knoten diese Änderungen nicht übernehmen, da sie jeweils über eigene Kopien der lokalen Umgebung verfügen. Dieses Verhalten kann bei einem FlowOrder-Knoten oder bei Verwendung des Weiterleitungsbefehls in einem Compute-Knoten zu Problemen führen.

Wenn Sie dieses Kontrollkästchen inaktivieren, generieren die einzelnen Knoten keine eigene Kopie der lokalen Umgebung, sondern sie verwenden die lokale Umgebung, die ihnen vom vorangegangenen Knoten übergeben wird. Falls also die lokale Umgebung in einem Knoten geändert wird, werden diese Änderungen von den vorgelagerten Knoten übernommen.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac37300_