Adapter-Menü 

Verwendung

Über das Menü Adapter der Adapter-Engine können Sie neue Adapter hinzufügen, vorhandene Adapter deaktivieren, und deaktivierte Adapter reaktivieren bzw. entfernen. Zudem können Sie vorhandene Adapter in der Detailsicht verwalten.

Voraussetzungen

Sie haben die Adapter-Engine sowie die gewünschten Adapter erfolgreich installiert, die Adapter-Engine gestartet und anschließend über Ihren Web Browser aufgerufen.

Funktionsumfang

Das Menü Adapter wird bereits beim Aufrufen der Konfigurationsoberfläche auf der rechten Bildschirmseite angezeigt. Es zeigt die verfügbaren (installierten) Adapter mit ihrem gegenwärtigen Status an, wobei eine Ampel den Zustand des aktuellen Status anzeigt. Hierbei steht eine grüne Ampel für fehlerfrei, eine rote Ampel für fehlerhaft, und eine gelbe Ampel für unbekannt.

Das Menü und bietet Ihnen die folgenden Funktion:

●      Adapter umbenennen

Mit dieser Funktion können Sie einen bestehenden Adapter umbenennen. Hierzu verfahren Sie wie folgt:

...

                            a.      Wählen Sie die Funktion per Mausklick aus.

Eine Auswahlliste der aktuell aktiven Adapter erscheint.

                            b.      Wählen Sie einen Adapter aus der Liste aus.

                            c.      Geben Sie einen neuen Namen für den Adapter ein.

                            d.      Markieren Sie das Ankreuzfeld automatischer Start, wenn dieser Adapter bei einem Neustart der Adapter-Engine automatisch gestartet werden soll. Sonst verbleibt der Adapter nach einem Neustart im Status INITIALISIERT und Sie müssen ihn per Hand aus dem Adapter-Menü starten.

                            e.      Wählen Sie Umbenennen, um die Umbenennung durchzuführen.

Nach dem Umbenennen erscheint die Konfiguration nun in der Auswahlliste des Adapter-Menüs unter ihrem neuen Namen.

●      Neuen Adapter hinzufügen

Mit dieser Funktion können Sie aus einem bestehenden Adapter eine neue Adapter-Konfiguration erzeugen. Hierzu verfahren Sie wie folgt:

...

                            a.      Wählen Sie die Funktion per Mausklick aus.

Eine Auswahlliste der aktuell aktiven Adapter erscheint.

                            b.      Wählen Sie einen Adapter aus der Liste aus.

                            c.      Geben Sie einen Namen für den neu zu erstellenden Adapter ein.

                            d.      Markieren Sie das Ankreuzfeld automatischer Start, wenn dieser Adapter bei einem Neustart der Adapter-Engine automatisch gestartet werden soll. Sonst verbleibt der Adapter nach einem Neustart im Status INITIALISIERT und Sie müssen ihn per Hand aus dem Adapter-Menü starten.

                            e.      Wählen Sie Anlegen, um eine Adapter-Konfiguration mit dem neuen Namen zu anzulegen, die alle Einstellungen der als Vorlage ausgewählten Adapter-Konfiguration übernimmt.

Die Konfiguration erscheint nun in der Auswahlliste des Adapter-Menüs unter ihrem neuen Namen und kann dort editiert werden, um die kopierten Einstellungen anzupassen.

Sie dürfen auf keinen Fall völlig identische Adapter-Konfigurationen unter verschiedenen Namen aktivieren. Dies ist meist auch technisch gar nicht möglich und führt zu einer Fehlermeldung beim Initialisieren des neuen Adapters. Im Einzelfall kann es aber auch zu unvorhergesehenen Ergebnissen mit Nachrichtenduplikaten oder Nachrichtenverlust führen.

●      Adapter deaktivieren

Mit dieser Funktion können Sie bestehende Adapter aus dem Adapter-Menü entfernen (deaktivieren). Die Adapter-Konfigurationen werden aber nicht gelöscht und können gegebenenfalls wieder in das Adapter-Menü aufgenommen (reaktiviert) werden. Verfahren Sie wie folgt:

...

                            a.      Wählen Sie die Funktion per Mausklick aus.

Eine Auswahlliste der aktuell aktiven Adapter erscheint.

                            b.      Wählen Sie einen oder mehrere Adapter aus der Liste aus.

                            c.      Wählen Sie Deaktivieren, um die ausgewählten Adapter aus dem Adapter-Menü zu entfernen.

●      Deaktivierte Adapter reaktivierten

Mit dieser Funktion können Sie bestehende, aber deaktivierte Adapter wieder in das Adapter-Menü aufnehmen. Verfahren Sie wie folgt:

...

                            a.      Wählen Sie die Funktion per Mausklick aus.

Eine Auswahlliste der aktuell deaktivierten Adapter erscheint.

                            b.      Wählen Sie einen oder mehrere Adapter aus der Liste aus.

                            c.      Markieren Sie das Ankreuzfeld automatischer Start, wenn alle ausgewählten Adapter bei einem Neustart der Adapter-Engine automatisch gestartet werden soll. Sonst verbleiben die Adapter nach einem Neustart im Status INITIALISIERT und Sie müssen sie per Hand aus dem Adapter-Menü starten.

                            d.      Wählen Sie Reaktivieren, um die ausgewählten Adapter wieder in das Adapter-Menü aufzunehmen.

Kopieren von Adapter-Konfigurationen aus anderen Installationen

Da der Name eines deaktivierten Adapters zwar nicht mehr von der Adapter-Engine verwaltet wird, eine gleichnamige Properties-Datei aber noch im Konfigurationsverzeichnis der Adapter-Engine existiert, können Sie diese Funktion auch benutzen, um Adapter-Konfigurationen aus anderen Installationen der Adapter-Engine zu kopieren.

Hierzu kopieren Sie die Quelldatei <AdapterName>.properties aus dem Verzeichnis ../tech_adapter/Configuration in das gleiche Verzeichnis der Zielinstallation. Sie erscheint damit automatisch in der Liste der deaktivierten Adapters und kann entsprechend reaktiviert werden.

Ändern des Start-Modus für einen Adapter

Haben Sie für einen Adapter einen automatischen Start definiert, können Sie den Start-Modus über die Funktion Adapter deaktivieren ändern.

Hierzu deaktivieren Sie zunächst den oder die gewünschten Adapter und reaktivieren sie anschließend wieder mit dem gewünschten Start-Modus.

●      Deaktivierte Adapter entfernen

Mit dieser Funktion können Sie bestehende, aber deaktivierte Adapter endgültig löschen. Gelöschte Adapter-Konfigurationen können nicht mehr reaktiviert werden. Verfahren Sie wie folgt:

...

                            a.      Wählen Sie die Funktion per Mausklick aus.

Eine Auswahlliste der aktuell deaktivierten Adapter erscheint.

                            b.      Wählen Sie einen oder mehrere Adapter aus der Liste aus.

                            c.      Wählen Sie Entfernen, um die ausgewählten Adapter zu löschen.

●      Adapter-Menü auffrischen

Mit der Funktion Auffrischen können Sie das Adapter-Menü neu laden, um die Anzeige des Status und des Zustands aller Adapter zu aktualisieren.

Aktivitäten

Per Mausklick auf einen der angezeigten Adapter gelangen Sie in die Detailsicht zu diesem Adapter.

In der Detailsicht wird Ihnen der Name, der Typ, die Version, und der Status des Adapters angezeigt, wobei – wie im Adapter-Menü – eine Ampel den Zustand des aktuellen Status angibt. Hierbei steht eine grüne Ampel für fehlerfrei, eine rote Ampel für fehlerhaft, und eine gelbe Ampel für unbekannt.

Falls vorhanden, sehen Sie im Bereich Protokoll ein adapter-spezifisches Protokoll.

Von der Detailsicht können Sie

●      zum Hauptmenü zurückkehren

●      über Neu laden den angezeigten Inhalt aktualisieren

Es soll der jeweils aktuelle Status des Adapters angezeigt werden (also INITIALISIERT, GESTARTET, ANGEHALTEN, oder BEENDET). Da aber die entsprechenden und nachfolgend beschriebenen Aktionen teilweise asynchron abgearbeitet werden können, kann diese Anzeige auch einen Zwischenstatus anzeigen. Dies gilt insbesondere für die Aktion Neu starten, bei der nacheinander die Status ANGEHALTEN, BEENDET, INITIALISIERT, und GESTARTET durchlaufen werden. In diesem Fall kann über Neu laden die Anzeige aktualisiert werden.

●      den Adapter

○       konfigurieren

Über Konfigurieren rufen Sie die Konfiguration auf, die Sie benötigen, um den Adapter zu konfigurieren. Sie erscheint in einem Fenster im Bereich Konfiguration.

Wenn Sie die Benutzerrolle Administrator oder Konfigurator besitzen, haben Sie folgende Möglichkeiten:

■       Wählen Sie Anzeigen/Ändern, um zwischen Anzeigemodus und Änderungsmodus zu wechseln.

■       Wählen Sie Konfigurationsdaten speichern, um im Änderungsmodus geänderte Konfigurationsdaten abzuspeichern.

■       Wählen Sie Abbrechen, um im Änderungsmodus vorgenommene, aber noch nicht gespeicherte Änderungen der Konfiguration aus der Anzeige zu löschen.

Der Name der Konfiguration wird unterhalb des Fensters angezeigt.

Grundsätzlich werden Änderungen der Konfiguration nur durch Konfigurationsdaten speichern übernommen. Wenn Sie die Konfiguration durch eine andere Aktion verlassen (beispielsweise über eine der Drucktasten auf der linken Seite der Detailsicht) bleibt die ursprüngliche Konfiguration erhalten und wird bei einem erneuten Aufruf der Konfiguration auch so angezeigt.

Um eine geänderte Konfiguration eines Adapters zu aktivieren, müssen Sie den Adapter immer neu initialisieren. Verwenden Sie hierzu entweder die Funktionen Beenden und Anlegen oder die Funktion Neu Starten, die die Funktionen Beenden, Anlegen und Starten vereint.

Es genügt nicht, die Funktionen Anhalten und Starten durchzuführen, da hierbei der Adapter nicht neu initialisiert wird und somit geänderte Konfigurationsdaten nicht erkannt werden.

○       starten

Über Starten starten Sie den Adapter. Hierzu müssen Sie ihn zumindest einmal über Konfigurieren konfiguriert und über Anlegen erstellt haben. Adapter, die mit Anhalten in einen Wartezustand versetzt wurden, können ebenfalls mit Starten neu gestartet werden.

○       anlegen

Über Anlegen wird der Adapter neu erzeugt und initialisiert. Dies wird notwendig, wenn Sie die Konfigurationsdaten geändert haben oder wenn Sie die aktuelle Instanz des Adapters über Beenden gelöscht haben.

○       neu starten

Über Neu starten starten Sie den Adapter neu, ganz gleich in welchem Status er sich gerade befindet. Dies wird notwendig, wenn Sie zum Beispiel die Konfiguration geändert haben. Diese Aktion entspricht den nacheinander ausgeführten Aktionen Beenden, Anlegen und Starten.

○       anhalten

Über Anhalten halten Sie einen zuvor gestarteten Adapter an. Der Adapter befindet sich dann in einem Wartezustand und kann entweder über Starten wieder gestartet oder mit Beenden vollständig beendet werden.

○       beenden

Über Beenden beenden Sie die aktuelle Instanz des Adapters, wenn Sie diese zum Beispiel nicht mehr benötigen, oder wenn sie nicht mehr wie gewünscht funktioniert.

●      das adapter-spezifische Protokoll anzeigen und löschen