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.

PeopleSoftRequest-Knoten

Mit dem PeopleSoftRequest-Knoten können Sie mit einer PeopleSoft-Anwendung interagieren.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Mit dem PeopleSoftRequest-Knoten können Sie mit PeopleSoft-Anwendungen interagieren. Beispiel: Ein PeopleSoftRequest-Knoten fordert Informationen von einem unternehmensweiten PeopleSoft-Informationssystem an. Ein Kunden-Geschäftsobjekt wird an PeopleSoft gesendet. Daraufhin ruft PeopleSoft Informationen zu einem Kunden wie beispielsweise Adress- und Accountdaten ab. Die Antwortinformationen, die vom PeopleSoftRequest-Knoten abgerufen werden, können dann vom übrigen Nachrichtenfluss verwendet werden. Der PeopleSoftRequest-Knoten kann Geschäftsdaten senden und empfangen.

Der PeopleSoftRequest-Knoten befindet sich im Ablagefach WebSphere Adapters (WebSphere-Adapter) der Nachrichtenflussknotenpalette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für PeopleSoftRequest-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Damit der PeopleSoftRequest-Knoten ordnungsgemäß funktioniert, ist eine Adapterkomponente erforderlich, die Sie über die Knoteneigenschaft Adapterkomponente festlegen. Außerdem sind Geschäftsobjekt-Definitionen erforderlich, 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 PeopleSoftRequest-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.

Stellen Sie sicher, dass Nachrichten, die an den PeopleSoftRequest-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 PeopleSoftRequest-Knoten erstellt werden. Wenn jedoch Daten an den PeopleSoftRequest-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 PeopleSoftRequest-Knoten unterstützt lokale Transaktionen unter Verwendung des lokalen Transaktionsmanagers des Brokers und globale Transaktionen unter Verwendung des externen Synchronisationspunktkoordinators des Brokers.

Zur effizienten Verwaltung des Verbindungspools für PeopleSoft können Sie in einem konfigurierbaren Service ein Verbindungszeitlimit festlegen. Der Abschnitt EIS-Verbindungen für den Ablauf nach einer festgelegten Zeit konfigurieren enthält weitere Informationen hierzu.

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 PeopleSoft Enterprise können Sie den Befehl mqsisetdbparms im folgenden Format verwenden.
mqsisetdbparms
Brokername -n Adaptername -u Benutzername
-p Kennwort
Beispiel:
mqsisetdbparms BRK1 -n eis::PeopleSoftCustomerOutbound.outadapter -u peoplesoftuid -p ********

Konfigurierbare Services für PeopleSoft-Knoten verwenden

PeopleSoft-Knoten können PeopleSoft-Verbindungsdetails entweder aus der Adapterkomponente oder aus 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 PeopleSoft finden Sie im Abschnitt Verbindungsdetails für PeopleSoft-Adapter ändern.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des PeopleSoftRequest-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 den PeopleSoftRequest-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 PeopleSoftRequest-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 PeopleSoftRequest-Knoten wird die Nachricht an das Fehlerterminal (Failure) weitergegeben. Auch Informationen zum Fehler und zu den Geschäftsobjektereignissen können an das Fehlerterminal (Failure) weitergeleitet werden.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O 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 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 PeopleSoftRequest-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Knotentyp, z. B. PeopleSoftRequest 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 PeopleSoftRequest-Knotens beschrieben.
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 PeopleSoftRequest-Knoten Daten aus dem PeopleSoft-System empfängt, ordnet er diesen Daten einen Methodennamen zu. Der PeopleSoftRequest-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 PeopleSoftRequest-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 einem beliebigen ausgehenden PeopleSoft-Adapter definiert sind, der in derselben Anwendung implementiert ist. 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 PeopleSoft-Adapter definiert sind, welcher ebenfalls als unabhängige Ressource implementiert ist.

secondaryAdapterMode
Standardmethode Ja Ja   Die zu verwendende Standardmethodenbindung. defaultMethod
In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Antwortnachricht' des PeopleSoftRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Nachrichtendomäne Nein Nein DataObject Die Domäne für die Syntaxanalyse der Antwortnachricht. Standardmäßig befindet sich die Antwortnachricht, die vom PeopleSoftRequest-Knoten weitergegeben wird, in der DataObject-Domäne. Sie können keine andere Domäne angeben.
Nachrichtengruppe Ja Nein Wird automatisch festgelegt. Der Name der Nachrichtengruppe, in der die Antwortnachricht 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.
In der folgenden Tabelle werden die Eigenschaften für die Transaktionalität des PeopleSoftRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Transaktionsmodus Nein Nein Nein Diese Eigenschaft legt fest, dass Aktualisierungen unabhängig, d. h. nicht als Teil einer lokalen Transaktion, durchgeführt werden. Diese Eigenschaft kann nicht geändert werden.
In der folgenden Tabelle werden die Anforderungseigenschaften des PeopleSoftRequest-Knotens beschrieben.
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 PeopleSoftRequest-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 PeopleSoftRequest-Knoten an das unternehmensweite Informationssystem (EIS) gesendet werden.
In der folgenden Tabelle werden die Ergebniseigenschaften des PeopleSoftRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Position für Ausgabedaten Nein Nein $OutputRoot Die Position in der Nachrichtenbaumstruktur, an die der PeopleSoftRequest-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.

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:14


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac37340_