Mit dem SAPInput-Knoten können Sie die Eingabe aus einer SAP-Anwendung akzeptieren.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Mit dem SAPInput-Knoten können Sie die Eingabe aus SAP-Anwendungen akzeptieren. Beispiel: Der SAPInput-Knoten überwacht das SAP-System und prüft, ob neue Aufträge eingegangen sind. Wenn ein neuer Auftrag eingegangen ist, generiert der SAPInput-Knoten eine Nachrichtenbaumstruktur, die das Geschäftsobjekt mit den Details zum neuen Auftrag wiedergibt. 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 SAPInput-Knoten befindet sich im Ablagefach WebSphere Adapters (WebSphere-Adapter) der Nachrichtenflussknotenpalette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Der SAPInput-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 SAPInput-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 SAPInput-Knoten füllt die Zieladressenliste für die Weitleitung an Zieladressen mit dem Namen der Methodenbindung. Wenn Sie einen RouteToLabel-Knoten nach dem SAPInput-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::SAPCustomerInbound.inadapter -u sapuid -p ********
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.
Generisches IDoc-Routing
Durch Verwendung des SAPInput-Knotens im Durchgriffsmodus kann WebSphere Message Broker jedes IDoc empfangen und abhängig vom IDoc-Typ weiterleiten. Der Abschnitt Generisches IDoc-Routing enthält weitere Informationen hierzu. Über ein Muster können Sie IDocs verschiedener Arten mit nur einer RFC-Programm-ID verarbeiten und müssen selbst beim Hinzufügen neuer IDoc-Typen keine bestehenden Nachrichtengruppen und -adapter erneut implementieren oder erneut erkennen. Sie finden weitere Informationen in der Beschreibung des Musters: Datenverteilung SAP für WebSphere MQ: unidirektional (für IDoc). Sie können Muster im Information Center nur über die Links anzeigen, wenn Sie das Information Center, das im WebSphere Message Broker Toolkit integriert ist, oder die Onlineversion des Information Center verwenden.
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.
Nachdem Sie eine Instanz des SAPInput-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 SAPInput-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 SAPInput-Knotens beschrieben.
Terminal | Beschreibung |
---|---|
Ausgang | Geschäftsobjekt-Ereignisse des Adapters werden an das Ausgangsterminal weitergegeben. |
Fehlerterminal (Failure) | Bei einem Fehler im SAPInput-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 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 | Der Knotentyp, SAPInput | 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 Referenznachrichtengruppenprojekten verfügbar sind, eine Adapterdatei auszuwählen. Wenn der SAPInput-Knoten Daten aus dem SAP-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 SAPInput-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 übereinstimmenden eingehenden SAP-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 SAP-Adapter definiert sind, welcher ebenfalls als unabhängige Ressource implementiert ist. |
secondaryAdapterMode |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Maximale Client-Wartezeit (Sekunden) | Nein | Ja | 60 | Die Zeit (in Sekunden), die das SAP-System auf eine Antwort von einem SAPReply-Knoten wartet. Der Standardwert beträgt 60 Sekunden. Wenn nach Überschreiten des Zeitlimits eine Antwort an einen SAPReply-Knoten gesendet wird, gibt der SAPReply-Knoten eine Ausnahmebedingung aus. Falls der Broker gestoppt wird, solange der Adapter auf eine Antwort von einem SAPReply-Knoten wartet, wird ein Systemfehler an das SAP-System zurückgesendet. Wenn Sie diese Eigenschaft auf null (0) setzen, wartet das SAP-System unbegrenzt auf die Antwort von einem SAPReply-Knoten. Diese Eigenschaft findet nur beim synchronen Callback-Modus Anwendung; bei asynchronen BAPIs oder IDOCs wird sie nicht verwendet. Wenn Sie diese Eigenschaft für einen SAPInput-Knoten festlegen, der mit einem Adapter konfiguriert ist, welcher nicht für einen synchronen Callback konfiguriert ist, wird eine Warnung ausgegeben. |
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, so dass Sie einen RouteToLabel-Knoten nach dem SAPInput-Knoten im Nachrichtenfluss verwenden können. |
Zieladressenpräfix | Nein | Nein | Das Präfix, das bei der Weiterleitung an einen Kennsatz 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, so dass 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 SAPInput-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 später aktualisieren, um diesen Nachrichtensatzverweis zu entfernen, wird eine Warnung 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 | Nein | Ja | Der Transaktionsmodus auf diesem Empfangsknoten bestimmt, ob die übrigen Knoten im Nachrichtenfluss unter Verwendung eines Synchronisationspunktes ausgeführt 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 | Failure | Gibt an, wie die Wiederholungsverarbeitung erfolgen soll, wenn ein Fehler zum SAPInput-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. |