Jython-Beispiel-Skripts

Mit der Management Console werden Jython-Beispiel-Skripts ausgeliefert. Diese Skripts geben die vorhandenen Objekte des entsprechenden Typs mit ihren Eigenschaften aus. Zusätzlich können neue Test-Objekte erzeugt, modifiziert oder gelöscht werden. Die Namen der Testobjekte beginnen mit "test bzw. "TEST". Je nach Konfiguration werden Aktionen (Statusabfrage, Start, Stop) gestartet.

Nach der Installation der Management Console stehen folgende Skripts im Installationsverzeichnis der Management Console im Unterverzeichnis cli-sample zur Verfügung:

• startBcAdmin.cmd (für Windows-Systeme) bzw. startBcAdmin.sh (für Linux-Systeme) – Start-Skript.

  startBcAdmin.cmd bzw. startBcAdmin.sh ruft das Skript sampleMccliStart.py auf.

• sampleMccliStart.py - Start Jython-Skript, von dem aus abhängig von den angegebenen Optionen die gewünschten Beispiel-Skripts aufgerufen werden.

• sampleAdminCommService.py - Jython-Skript mit Funktionen des Moduls BcAdminCommunicationService.

• sampleAdminEisPartner.py – Jython-Skript mit Funktionen des Moduls BcAdminEisPartner.

• sampleAdminInbound.py – Jython-Skript mit Funktionen der Module BcAdminInboundUser, BcAdminInboundService, BcAdminInboundMsgEndpoint.

• sampleAdminLu62Gateway.py - Jython-Skript mit Funktionen des Moduls BcAdminLu62Gateway.

• sampleAdminMain.py – Jython-Skript mit Funktionen der Module BcAdminMain und BcAdminTodo.

• sampleAdminProxy.py – Jython-Skript mit Funktionen des Moduls BcAdminProxy.

• sampleAdminProxyCluster.py – Jython-Skript mit Funktionen des Moduls BcAdminProxyCluster.

• sampleAdminRa.py – Jython-Skript mit Funktionen des Moduls BcAdminRA.

• sampleAdminOutbound.py – Jython-Skript mit Funktionen der Module BcAdminOutboundService, BcAdminOutboundCommEndpoint.

• sampleInitConfig.template.py - Template für die Anpassung der Konfigurationsdaten und den gewünschten Umfang der Beispiele.

Einsatz der Jython-Beispiel-Skripts

Gehen Sie in folgenden Schritten vor:

• Setzen Sie im Start-Skript startBcAdmin.cmd bzw. startBcAdmin.sh die Umgebungsvariable JYTHONPATH.

• Erzeugen Sie eine überschreibbare Kopie von sampleInitConfig.template.py mit dem Namen sampleInitConfig.py. Diese Datei muss immer im selben Verzeichnis liegen, in dem sich die Skripts befinden (Standard nach Installation: cli-sample). Sie wird von allen Jython-Beispiel-Skripts verwendet.

• Passen Sie die Konfigurationsdatei sampleInitConfig.py an, siehe Abschnitt „Konfigurationsdatei editieren“.

• Rufen Sie das Start-Skript StartBcAdmin.cmd/sh auf, siehe Abschnitt „Start-Skript aufrufen“. Dabei geben Sie über Aufruf-Optionen an, welche Skripts und Funktionen ausgeführt werden sollen.

Sie können jedes Jython-Beispiel-Skript auch als Hauptprogramm starten, müssen dann aber die Parameter, die im Start-Skript versorgt werden, manuell angeben. Daher wird empfohlen, die Skripts über das zentrale Start-Skript mit entsprechenden Optionen zu starten.

Konfigurationsdatei editieren

Die Konfigurationsdatei sampleInitConfig.py enthält Angaben zu den Objekten, die von den Beispiel-Skripts gelesen werden sollen. Außerdem werden in dieser Datei Ablaufparameter festgelegt.

Gehen Sie wie folgt vor:

• Ersetzen Sie in sampleInitConfig.py die Platzhalter "****" der einzelnen Objektparameter für den Proxy, EIS Partner, Resource Adapter usw. durch die aktuellen Werte. Folgende Objektparameter gelten für alle Skripts:

  console_home 

  Installationsverzeichnis der Management Console. Alternativ kann die Information auch über die Umgebungsvariable BEANCONNECT_USERCONS gelesen werden.

  proxy_name 

  Name des Proxys, für den die Funktionen ausgeführt werden sollen (nicht notwendig bei sampleAdminMain.py).

  admin_pw 

  Passwort des Proxys, für den die Funktionen ausgeführt werden sollen (nicht notwendig bei sampleAdminMain.py).

  Details zu den anderen Parametern finden Sie in der Inline-Beschreibung in sampleInitConfig.py.
   

• Ändern Sie in sampleInitConfig.py die voreingestellten Ablaufparameter (Erzeugen, Modifizieren, Sichern, Löschen, Proxy starten/stoppen) falls gewünscht. Es gibt folgende Ablaufparameter:

  • bCreDelObjs=True/False
    Test-Objekte erzeugen und entfernen (die Objektnamen beginnen mit "test" bzw. "TEST")

  • bModObjs=True/False
    Test-Objekte modifizieren.

  • bSaveMod=True/False
    Konfigurationsänderungen speichern.

  • weitere Skript-spezifische Schalter (siehe auch die Kommentare in sampleInit-Config.py).

  In der Regel wird bei bCreDelObjs=bModObjs=bSaveMod=True in einem ersten Durchlauf der Skripts ein Test-Objekt erzeugt und modifiziert, das in einem zweiten Lauf entfernt wird. Gesteuert wird die Funktionsabfolge in der Regel über den Wert der Eigenschaft desc ( "created" -> "modified" -> remove object):

  • Existiert ein Test-Objekt nicht, wird es erzeugt mit desc="created".

  • Existiert ein Test-Objekt und ist desc= created", wird es modifiziert (desc="modified").

  • Existiert ein Test-Objekt und ist desc="modified", wird es aus der Konfiguration entfernt.

Start-Skript aufrufen

Öffnen Sie die Windows-Eingabeaufforderung bzw. eine Linux-Shell und geben im Verzeichnis cli-sample folgendes Kommando ein:

startBcAdmin.cmd [options] (Windows-Systeme)

startBcAdmin.sh [options] (Linux-Systeme)

Mit options steuern Sie den Funktionsumfang. Folgende Werte sind möglich:

-help oder -h	Hilfe-Funktion, gibt nur die möglichen Parameter mit Erklärung aus. Standardwert, wenn keine Option angegeben wurde.
-all	startet alle Beispiel-Skripts sampleAdminXxx.
-cs	startet sampleAdminCommService.py.
-ei	startet sampleAdminEisPartner.py.
-gw	startet sampleAdminLu62Gateway.py.
-in	startet sampleAdminInbound.py.
-main	startet sampleAdminMain.py.
-out	startet sampleAdminOutbound.py.
-proxy	startet sampleAdminProxy.py.
-proxy-cl	startet sampleAdminProxyCluster.py.
-ra	startet sampleAdminRa.py.
-log	Logging-Funktion, d.h. ausführliche Ausgabe der gelesenen Informationen (Listenelemente, Eigenschaften der gelesenen Objekte). Dies Angabe ist zusätzlich zu allen vorher aufgeführten Optionen möglich.