Mit dem SAPRequest-Knoten können Sie Anforderungen an SAP-Anwendungen senden.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Mit dem SAPRequest-Knoten können Sie Anforderungen an SAP-Anwendungen senden. 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 im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Der SAPRequest-Knoten benötigt zur ordnungsgemäßen Funktion eine Adapterkomponente. Sie legen die Komponente fest, indem Sie die Knoteneigenschaft Adapterkomponente und Geschäftsobjekt-Definitionen verwenden, die in der Nachrichtengruppe 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, sodass für die Eigenschaft Nachrichtendomäne der Wert 'DataObject' definiert ist. Sie können keine andere Domäne angeben. Der Knoten erkennt den Nachrichtentyp automatisch.
Stellen Sie sicher, dass Nachrichten, die an den SAPRequest-Knoten übergeben werden, die richtigen Datentypen enthalten, um die Leistung zu maximieren und unnötige Datenkonvertierungen zu vermeiden. Die DataObject-Domäne ist die Standarddomäne, wenn Nachrichten analysiert werden, die vom SAPRequest-Knoten erstellt werden. Wenn jedoch Daten an den SAPRequest-Knoten übergeben werden (z. B. mithilfe eines MQInput-Knotens), kann durch die Verwendung einer anderen Domäne die Leistung verbessert werden. Verwenden Sie beispielsweise den XMLNSC-Parser mit dem MQInput-Knoten, um X ML-Nachrichten zu analysieren.
Der SAPRequest-Knoten unterstützt lokale Transaktionen unter Verwendung des lokalen Transaktionsmanagers des Brokers.
Sie können mehrere Anforderungsknoten von WebSphere Adapters, die dieselbe Adapterkomponente verwenden, in einer Ausführungsgruppe implementieren.
Der SAPRequest-Knoten kann eine Identität aus einer Eingabenachricht an SAP weitergeben. Dazu wird die Eigenschaft Propagate (Weitergeben) des für den Knoten definierten Sicherheitsprofils verwendet. Der Abschnitt Sicherheitsberechtigungsnachweise an eine SAP-Anforderung weitergeben enthält weitere Informationen hierzu.
Zur effizienten Verwaltung des Verbindungspools für SAP können Sie in einem konfigurierbaren Service ein Verbindungszeitlimit festlegen. Standardmäßig ist die Eigenschaft "connectionIdleTimeout" auf Null gesetzt, d. h., kein Zeitlimit ist festgelegt. Da neue Verbindungen zu SAP aber mit verschiedenen Benutzer-IDs geöffnet werden, sollten Sie diese Eigenschaft nicht auf Null setzen, wenn Sie die Weitergabe von Identitäten verwenden. Der Abschnitt EIS-Verbindungen für den Ablauf nach einer festgelegten Zeit konfigurieren enthält weitere Informationen hierzu.
mqsisetdbparms Brokername -n Adaptername -u Benutzername -p KENNWORT
Beispiel:mqsisetdbparms BRK1 -n eis::SAPCustomerOutbound.outadapter -u sapuid -p ********
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.
Konfigurierbare Services für SAP-Knoten verwenden
SAP-Knoten können SAP-Verbindungsdetails entweder von der Adapterkomponente oder von einem konfigurierbaren Service abrufen. Bei Verwendung eines konfigurierbaren Service können Sie die Verbindungsdetails für einen Adapter ändern, ohne den Adapter erneut implementieren zu müssen. Weitere Informationen zum Erstellen, Ändern, Dokumentieren und Löschen der konfigurierbaren Services für SAP finden Sie im Abschnitt Verbindungsdetails für SAP-Adapter ändern.
Nachdem Sie eine Instanz des SAPRequest-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Eigenschaften des Knotens werden in der Ansicht 'Eigenschaften' angezeigt. Durch Doppelklicken auf einen SAPRequest-Knoten wird der Adapterverbindungsassistent 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.
In der folgenden Tabelle werden die Terminals des SAPRequest-Knotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingabeterminal (In) | 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 (Failure) | Bei einem Fehler im SAPRequest-Knoten wird die Nachricht an das Fehlerterminal (Failure) weitergegeben. Auch Informationen zum Fehler und zu den Geschäftsobjektereignissen können an das Fehlerterminal weitergeleitet werden. |
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).
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | Knotentyp, z. B. SAPRequest | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens. | |
Langbeschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Primäradapterkomponente | 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. Wenn der SAPRequest-Knoten Daten aus dem SAP-System empfängt, ordnet er diesen Daten einen Methodennamen zu. Der SAPRequest-Knoten versucht, die im Primäradapter definierten Methoden aufzurufen. Wenn die Methode nicht im Primäradapter definiert ist, kann der Knoten Methoden aufrufen, die in übereinstimmenden Sekundäradaptern definiert sind, welche in der gleichen Ausführungsgruppe implementiert sind. |
||
Sekundäradaptermodus | Nein | Ja | Ohne | Gibt an, ob der Knoten die in Sekundäradaptern definierten Methoden aufrufen kann. Wenn Sie die Eigenschaft Sekundäradaptermodus auf Keine gesetzt haben, ruft der SAPRequest-Knoten nur Methoden auf, die im Primäradapter definiert sind. Wenn die Methode nicht im Primäradapter definiert ist, tritt ein Fehler auf. Wenn Sie diese Eigenschaft auf Alle Adapter in Anwendung setzen, kann der Knoten Methoden aufrufen, die in übereinstimmenden ausgehenden SAP-Adaptern definiert sind, die in derselben Anwendung definiert sind. Wenn der Knoten als unabhängige Ressource implementiert wird (also nicht in einer Anwendung enthalten ist), kann er Methoden aufrufen, die in einem beliebigen ausgehenden SAP-Adapter definiert sind, welcher ebenfalls als unabhängige Ressource implementiert ist. |
secondaryAdapterMode |
Standardmethode | Ja | Ja | Die zu verwendende Standardmethodenbindung. Diese Eigenschaft
listet die Methoden auf, die durch den Adapter definiert sind. Sie können diese Eigenschaft außer Kraft setzen, indem Sie den Methodennamen in der untergeordneten Baumstruktur 'LocalEnvironment.Adapter' festlegen. Der Abschnitt Baumstruktur für die lokale Umgebung enthält weitere Informationen hierzu. Die Methodennamen entsprechen den Serviceoperationsnamen, die vom Assistenten für die Adapterverbindung konfiguriert werden. In den meisten Fällen basieren die Namen auf dem Namen des Service, der erkannt wird (z. B. BAPI). |
defaultMethod |
Eigenschaft | O | K | 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. Wenn Sie diese Eigenschaft festlegen und die Projektabhängigkeiten anschließend aktualisieren, um diesen Nachrichtensatzverweis zu entfernen, wird eine Warnmeldung ausgegeben. Aktualisieren Sie entweder die Eigenschaft Nachrichtensatz, oder stellen Sie den Verweis auf dieses Nachrichtensatzprojekt wieder her. |
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. |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Transaktionsmodus | Nein | Nein | Automatisch | Gibt an, wie Aktualisierungen verarbeitet werden sollen.
Weitere Informationen zur Transaktionalität finden Sie im Abschnitt BAPI-Transaktionsfestschreibung für SAP. |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Methodenposition | Ja | Nein | $LocalEnvironment/Adapter/MethodName | Die Position der Geschäftsmethode (z. B. createPurchaseOrder oder deletePurchaseOrder), die verwendet wird, um die Ausführung einer Aktion auf dem externen System durch den SAPRequest-Knoten auszulösen. |
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 unternehmensweite Informationssystem (EIS) gesendet werden. |
Eigenschaft | O | K | 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 eine neue Kopie der lokalen Umgebung erstellt (an jedem Knoten des
Nachrichtenflusses). In diese Kopien wird jeweils der Inhalt der lokalen Umgebung des
vorangegangenen Knotens eingetragen. Wenn ein Knoten die lokale Umgebung ändert, werden diese
Änderungen daher den vorherigen Knoten nicht angezeigt, da sie über eigene Kopien 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. Wenn also in diesem Fall die lokale Umgebung für einen Knoten geändert wird, werden diese Änderungen auch von den vorgeordneten Knoten bemerkt. |
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. |