Mit dem PeopleSoftInput-Knoten können Sie mit einer PeopleSoft-Anwendung interagieren.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Mit dem PeopleSoftInput-Knoten können Sie mit PeopleSoft-Anwendungen interagieren. Beispielsweise kann ein PeopleSoftInput-Knoten verwendet werden, um ein PeopleSoft-System auf bestimmte Ereignisse zu überwachen. Wenn dieses Ereignis stattfindet, generiert der PeopleSoftInput-Knoten eine Nachrichtenbaumstruktur, die dasGeschäftsobjekt mit den Details zum neuen Ereignis darstellt. Die Nachrichtenbaumstruktur wird an das Ausgangsterminal weitergegeben, damit der Rest des Nachrichtenflusses die Daten zur Aktualisierung anderer Systeme oder zur Überprüfung der Änderungen verwenden kann.
Der PeopleSoftInput-Knoten befindet sich im Ablagefach WebSphere Adapters (WebSphere-Adapter) der Nachrichtenflussknotenpalette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Damit der PeopleSoftInput-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 PeopleSoftInput-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 PeopleSoftInput-Knoten füllt die Zieladressenliste für die Weitleitung an Zieladressen mit dem Namen der Methodenbindung. Wenn Sie einen RouteToLabel-Knoten nach dem PeopleSoftInput-Knoten zu einem Nachrichtenfluss hinzufügen, kann der RouteToLabel-Knoten den Namen der Methodenbindung verwenden, um die Nachricht an den korrekten Teil des Nachrichtenflusses zur Verarbeitung weiterzuleiten.
Sie können nur einen Empfangsknoten, der eine bestimmte Adapterkomponente verwendet, in einer Ausführungsgruppe implementieren, jedoch können Sie viele Empfangsknoten in einer Ausführungsgruppe implementieren, die unterschiedliche Adapterkomponenten verwenden.
mqsisetdbparms
Brokername -n Adaptername -u Benutzername
-p Kennwort
Beispiel:mqsisetdbparms BRK1 -n eis::PeopleSoftCustomerInbound.inadapter -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.
Nachdem Sie eine Instanz des PeopleSoftInput-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 PeopleSoftInput-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 PeopleSoftInput-Knotens beschrieben.
Terminal | Beschreibung |
---|---|
Ausgang | Geschäftsobjekt-Ereignisse des Adapters werden an das Ausgangsterminal weitergegeben. |
Fehlerterminal (Failure) | Bei einem Fehler im PeopleSoftInput-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. |
Catch-Terminal | Geschäftsobjektereignisse werden an das Catch-Terminal weitergegeben, wenn sie eine nicht abgefangene Ausnahmebedingung im Nachrichtenfluss verursachen. Wenn das Catch-Terminal nicht angeschlossen ist, wird der Wiederholungsprozess zur Verarbeitung des Geschäftsobjekts aktiviert. |
In der folgenden Tabelle 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 | Der Knotentyp, z. B. PeopleSoftInput. | 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. |
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Primäradapterkomponente | Ja | Ja | 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 PeopleSoftInput-Knoten Daten aus dem PeopleSoft-System empfängt, ordnet er diesen Daten einen Methodennamen zu. Dieser ist abhängig vom Namen der Serviceoperation, die diesem Datentyp bei der Ausführung des Adapteranschluss-Assistenten zugeordnet ist. Der PeopleSoftInput-Knoten versucht, die im Primäradapter definierten Methoden zu verarbeiten. Wenn der empfangene Datentyp nicht einer der im Primäradapter definierten Methoden entspricht, kann der Knoten Methoden verarbeiten, die in übereinstimmenden Sekundäradaptern definiert sind, welche in der gleichen Ausführungsgruppe implementiert sind. |
adapterComponent | |
Sekundäradaptermodus | Nein | Ja | Ohne | Gibt an, ob der Knoten die in Sekundäradaptern definierten Methoden verarbeiten kann. Wenn Sie die Eigenschaft Sekundäradaptermodus auf Keine gesetzt haben, verarbeitet der Knoten nur Methoden, die im Primäradapter definiert sind. Wenn der empfangene Datentyp nicht einer der im Primäradapter definierten Methoden entspricht, schlägt der Vorgang fehl. Wenn Sie diese Eigenschaft auf Alle Adapter in Anwendung setzen, kann der Knoten Methoden verarbeiten, die in beliebigen eingehenden PeopleSoft-Adaptern definiert sind, die in derselben Anwendung implementiert 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 eingehenden PeopleSoft-Adapter definiert sind, welcher ebenfalls als unabhängige Ressource implementiert ist. |
secondaryAdapterMode |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Zieladressenliste festlegen | Nein | Nein | Ausgewählt | Gibt an, ob die Methode 'Bindungsname' zur Zieladressenliste für die Weiterleitung an Zieladressen hinzugefügt werden soll. Wird dieses Kontrollkästchen aktiviert, wird die Methode 'Bindungsname' hinzugefügt, sodass Sie einen RouteToLabel-Knoten nach dem PeopleSoftInput-Knoten im Nachrichtenfluss verwenden können. |
Zieladressenpräfix | Nein | Nein | Das Präfix, das bei der Weiterleitung an Zieladressen zum Methodennamen hinzugefügt wird. Fügen Sie ein Zieladressenpräfix hinzu, um Konflikte zwischen den jeweiligen Kennsatzknoten zu vermeiden, wenn Sie mehrere WebSphere Adapters-Empfangsknoten in denselben Nachrichtenfluss aufnehmen. Das Kennsatzpräfix wird standardmäßig nicht eingefügt, sodass der Methodenname und die Kennsatzbezeichnung identisch sind. |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Nachrichtendomäne | Nein | Nein | DataObject | Die Domäne für die Syntaxanalyse der ankommenden Nachricht. Die Nachricht, die vom PeopleSoftInput-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 ankommenden Nachricht. Der Nachrichtentyp wird vom Knoten automatisch erkannt. Diese Eigenschaft kann nicht festgelegt werden. | |
Nachrichtenformat | Nein | Nein | Der Name des physischen Formats der eingehenden Nachricht. Diese Eigenschaft kann nicht festgelegt werden. |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Transaktionsmodus | Nein | Ja | Der Transaktionsmodus auf diesem Empfangsknoten ist entscheidend dafür, ob die übrigen Knoten im Fluss unter einem Synchronisationspunkt betrieben werden. |
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Pool zusätzlicher Instanzen | Nein | Ja | Pool verwenden, der dem Nachrichtenfluss zugeordnet ist | Der Pool, aus dem zusätzliche Instanzen beschafft werden.
|
componentLevel |
Zusätzliche Instanzen | Nein | Ja | 0 | Die Anzahl zusätzlicher Instanzen, die der Knoten starten kann, wenn die Eigenschaft Pool zusätzlicher Instanzen auf Dem Knoten zugeordneten Pool verwenden gesetzt ist. Standardmäßig werden dem Knoten keine zusätzlichen Instanzen bereitgestellt. | additionalInstances |
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Wiederholungsmechanismus | Nein | Nein | Fehlerterminal (Failure) | Diese Eigenschaft gibt an, wie die Wiederholungsverarbeitung erfolgen soll, wenn ein Fehler zum PeopleSoftInput-Knoten zurückgesetzt wird.
|
|
Wiederholungsschwellenwert | Nein | Ja | 0 | Gibt an, wie oft die Wiederholungsverarbeitung für die kurze Wiederholungszeit maximal erfolgt. | retryThreshold |
Kurzes Wiederholungsintervall | Nein | Ja | 0 | Das Intervall zwischen zwei kurzen Wiederholungsversuchen | shortRetryInterval |
Langes Wiederholungsintervall | Nein | Ja | 0 | Das Intervall zwischen zwei langen Wiederholungsversuchen | longRetryInterval |
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. |