Anschluss an den Adapter-Monitor
Verwendung
Die Schnittstellen des Adapter-Monitors werden vom Adapter-Framework verwendet, um Systemverwaltern den Zustand des Adapters, seiner Kanäle und seiner Unterkomponenten anzuzeigen.
Der Adapter-Monitor wird ab XI 3.0 SP17 und SAP NetWeaver 7.0, SP8 vom Kommunikationskanal-Monitor abgelöst. Die API und die Benutzeroberflächen des Adapter-Monitors bleiben jedoch enthalten, um ältere Adapterlösungen weiter lauffähig zu halten und überwachen zu können. Da der Kommunikationskanal-Monitor jedoch mehr Funktionen (Starten und Stoppen von Kanälen, Alerting) bietet, wird ein Umstieg empfohlen.
Siehe auch: Anschluss an den Kommunikationskanal-Monitor und Kommunikationskanal-Monitor
Interface-Überblick
Merkmal |
Wert |
Name |
Adapter-Framework Adapter-Monitor |
Zweck |
Abfrage des Adapterstatus zur Anzeige im Adapter-Monitor |
Typ |
J2EE-Service |
Technischer Name |
com.sap.aii.af.monitor.api |
Zertifizierung |
Optional |
Syntax |
Siehe unter Pfad: JavaDoc (.\index.html) package com.sap.aii.af.monitor.api |
Uml_monitor.wmf enthält das Klassendiagram in UML-Darstellung. Öffnen Sie hierzu Word und importieren Sie uml_monitor.wmf als Grafik.
Integration
● Rufen Sie den Adapter-Monitor über die Runtime Workbench der Einstiegsseite der SAP Exchange Infrastructure auf. Wählen Sie Komponenten-Monitoring, und als Komponente eine Adapter Engine. Auf der Registerkarte Status wählen Sie Adapter-Monitoring.
● Sie können den Adapter-Monitor unter //localhost:50000/AdapterFramework/monitor/monitor.jsp aufrufen. Die JavaServer Pages-Anwendung ruft die hier spezifizierte Schnittstelle auf, um die Adapterstatusdaten anzuzeigen.
Funktionsumfang
● Damit Ihr Adapter im Adapter-Monitor angezeigt wird, müssen Sie ihn am Adapter-Framework registrieren. Die Registrierung muss mit dem gleichen Adapternamen und Namensraum vorgenommen werden, mit dem die Adaptermetadaten angelegt sind, beziehungsweise mit dem Namen, der bei der CPA Callback-Registrierung verwendet wird.
Im Beispieladapter sind dies JCA als Adaptername und http://sap.com/xi/XI/sample als Namensraum.
Wird ein Adapter gestoppt, dann sollte er sich wieder deregistrieren. Sie können die Deregistrierung mit der MonitorManager-Klasse in com.sap.aii.af.monitor.api vornehmen.
● Das AdapterMonitor-Interface spezifiziert die Methode getStatus(), die vom Adapter-Monitor aufgerufen wird, wenn der entsprechende Adaptereintrag, wie er im CPA bekannt ist, ausgewählt wird. getStatus()liefert in einem Objekt der AdapterStatus-Klasse ein Array mit AdapterStatusData-Zeilen zurück, das den Status des Adapters, seiner Unterkomponenten und seiner Kanäle auflistet.
Sie können beispielsweise pro Kommunikationskanal eine Statuszeile und eine allgemeine Statuszeile pro Adapter zurückgeben. Es sind weitere Angaben je nach Architektur des Adapters möglich.
Melden Sie, wenn möglich, den aktuellen Status des Adapters zurück. Manche Adaptertypen haben ein bestimmtes Objekt für einen Kommunikationskanal nicht implementiert, weil sie z.B. auf einen Port hören und dort mittels Adressdaten dynamisch die Sendervereinbarung bestimmen. In solchen Fällen verwaltet der Adapter möglicherweise keinen Status des Kommunikationskanals und kann auch keinen Statuseintrag zurückliefern. Der Adapter sollte dann jedoch einen Subkomponentenstatus zurückliefern.
● In der Adapterkonfiguration im Integration Directory gibt es die Möglichkeit, einzelne Kanäle eines Adapters aktiv oder inaktiv zu schalten. Hierzu definieren Sie in den Adaptermetadaten das Attribut adapterStatus:
Fragen Sie den Wert Active und Inactive in Ihrem Adapter ab.
Falls ein Kanal inaktiv gesetzt wird, beenden Sie die Message-Bearbeitung für genau diesen Kanal. Belegte Ressourcen (Port, Dateien, etc.) sollten freigegeben werden.
Wird ein Kanal aktiv gesetzt, nehmen Sie die Message-Bearbeitung wieder auf.
<Attribute>
<Name>adapterStatus</Name>
<Usage>optional</Usage>
<Default>active</Default>
<DataType>xsd:string</DataType>
<Length>0</Length>
<GuiLabels><Label language="EN"></Label></GuiLabels>
<FixedValue>
<value>active</value>
<GuiLabels><Label language="EN">Active</Label></GuiLabels>
</FixedValue>
<FixedValue>
<value>inactive</value>
<GuiLabels><Label language="EN">Inactive</Label></GuiLabels>
</FixedValue>
</Attribute>
Adapterlösungen, die Funktionen zum Starten und Stoppen aus dem Kommunikationskanal-Monitor verwenden und vorher diesen Mechanismus über die Konfiguration im Integration Directory (Parameter Adapterstatus (Aktiv/Inaktiv)) angeboten haben, müssen diesen Mechanismus aufgrund der Kompatibilität mit alten Kommunikationskanalkonfigurationen beibehalten.