Benutzerdefinierte Prozeduren

Zum Anfang  Zurück  Weiter

Beim Ausführen von LUA-Scripts erhält der Administrator Zugriff auf das ganze Dateisystem innerhalb des Server-Verzeichnisses und auf einige Systembefehle auf dem Rechner mit dem installierten Server.

Um den Zugriff auf die benutzerdefinierten Prozeduren zu verwehren, deaktivieren Sie für den entsprechenden Administrator das Recht Server- bzw. Repository-Konfiguration bearbeiten (weitere Details finden Sie unter Administratoren und administrative Gruppen).

Um die Ausführung häufiger Aufgaben des Dr.Web Servers zu vereinfachen und automatisieren, können verschiedene benutzerdefinierte Prozeduren verwendet werden. Diese Prozeduren basieren auf Lua-Scripts.

Benutzerdefinierte Prozeduren befinden sich im folgenden Unterverzeichnis vom Installationsverzeichnis des Servers:

Unter Windows: var\extensions

Unter FreeBSD: /var/drwcs/extensions

Unter Linux und Solaris: /var/opt/drwcs/extensions

Nach der Installation des Servers befinden sich in diesem Unterverzeichnis vorinstallierte benutzerdefinierte Prozeduren.

Benutzerdefinierte Prozeduren sollten über das Verwaltungscenter bearbeitet werden.

So passen Sie benutzerdefinierte Prozeduren an

1.Wählen Sie im Hauptmenü des Verwaltungscenters den Punkt Administration.

2.Wählen Sie im nächsten Fenster den Punkt des Verwaltungsmenüs Benutzerdefinierte Prozeduren. Das Fenster für die Konfiguration benutzerdefinierter Prozeduren wird geöffnet.

Baumstruktur von Prozeduren

Prozeduren werden in der Baumansicht angezeigt. Gruppen von Prozeduren und dazu gehörende benutzerdefinierte Prozeduren stellen die Knoten dieser Baumstruktur dar.

Ursprünglich hat die baumartige Struktur der Prozeduren folgende vordefinierte Gruppen:

Examples of the hooks. Diese Gruppe enthält Vorlagen für alle verfügbaren benutzerdefinierten Prozeduren. Anhand dieser Vorlagen können Sie Ihre eigenen benutzerdefinierten Prozeduren erstellen.

IBM Tivoli integration. Diese Gruppe enthält Vorlagen der Prozeduren, die für die Integration mit dem IBM Tivoli-System notwendig sind.

Die Darstellung des Symbols eines Elements in der Struktur hängt vom Typ oder Status dieses Elements ab (s. die Tabelle unten).

Symbole der Elemente der Prozeduren-Struktur

Symbol

Erläuterung

Gruppen von Prozeduren

Gruppe, für welche die Ausführung von Prozeduren erlaubt ist.

Gruppe, für welche die Ausführung von Prozeduren verboten ist.

Prozeduren

Prozedur, für welche die Ausführung erlaubt ist.

Prozedur, für welche die Ausführung verboten ist.

Elemente in der Prozeduren-Struktur verwalten

Auf der Symbolleiste sind zur Verwaltung der Objekte in der Prozeduren-Struktur folgende Elemente verfügbar:

Dropdown-Liste, mit der Sie ein Element zur Baumstruktur der Prozeduren hinzufügen können. Verwenden Sie dafür die folgenden Schaltflächen:

Prozedur hinzufügen. Neue benutzerdefinierte Prozedur hinzufügen.

Gruppe von Prozeduren hinzufügen. Neue benutzerdefinierte Gruppe von Prozeduren erstellen.

Ausgewählte Objekte löschen. Eine in der Baumstruktur von Prozeduren gewählte benutzerdefinierte Prozedur bzw. Gruppe von Prozeduren entfernen.

Ausführen der Prozedur erlauben. Die gleiche Aktion kann im Prozedureneditor durch Aktivierung des Kontrollkästchens Ausführen der Prozedur erlauben durchgeführt werden. S. dazu auch Prozeduren aktivieren.

Ausführen der Prozedur verbieten. Die gleiche Aktion kann im Prozedureneditor durch Deaktivierung des Kontrollkästchens Ausführen der Prozedur erlauben durchgeführt werden. S. dazu auch Prozeduren aktivieren.

Gruppen von Prozeduren verwalten

So erstellen Sie eine Gruppe

1.Wählen Sie auf der Symbolleiste Gruppe von Prozeduren hinzufügen.

2.Legen Sie im angezeigten Dialogfeld folgende Parameter fest:

Aktivieren Sie das Kontrollkästchen Ausführen der Prozedur erlauben, um die Prozeduren, die in diese Gruppe aufgenommen werden, zu aktivieren. S. dazu auch Prozeduren aktivieren.

Geben Sie im Feld Name der Gruppe eine Namen für die neue Gruppe an.

3.Klicken Sie auf Speichern.

So ändern Sie die Reihenfolge der Gruppen

1.Ziehen Sie einfach die Gruppe von Prozeduren per Drag-and-drop an die gewünschte Position.

2.Die Reihenfolge, in der die Prozeduren ausgeführt werden, wird automatisch nach der Änderung der Reihenfolge der Gruppen angepasst: Als erste werden also die Prozeduren aus der in der Struktur höher stehenden Gruppen ausgeführt.

So verschieben Sie eine Prozedur in eine andere Gruppe

1.Wählen Sie in der Prozeduren-Struktur die gewünschte Prozedur aus.

2.Wählen Sie im angezeigten Eigenschaftenfenster aus der Dropdown-Liste Übergeordnete Gruppe die Gruppe aus, in welche die Prozedur verschoben werden soll.

3.Klicken Sie auf Speichern.

Prozeduren verwalten

So fügen Sie eine Prozedur hinzu

1.Wählen Sie auf der Symbolleiste Prozedur hinzufügen.

2.Legen Sie im angezeigten Dialogfeld folgende Parameter fest:

Aktivieren Sie das Kontrollkästchen Ausführen der Prozedur erlauben, um die zu erstellende Prozedur zu aktivieren. S. dazu auch Prozeduren aktivieren.

Wählen Sie in der Dropdown-Liste Übergeordnete Gruppe die Gruppe aus, zu der die zu erstellende Prozedur gehören soll. Nachträglich können Sie die Prozedur in eine andere Gruppe verschieben (s. oben).

Wählen Sie in der Dropdown-Liste Prozedur den gewünschten Typ der Prozedur aus. Der Typ der Prozedur bestimmt die Aktion, für welche die Prozedur aufgerufen werden soll.

Geben Sie in das Feld Text der Prozedur das Lua-Skript ein, das beim Aufruf der Prozedur ausgeführt werden soll.
Im Unterbereich Informationen über die Prozedur wird das Ereignis, für das diese Prozedur aufgerufen wird, Informationen über die Verfügbarkeit der Datenbank des Servers für diese Prozedur sowie Listen der Eingabeparameter und zurückgegebenen Werte für diesen Typ der Prozedur angegeben.

3.Klicken Sie auf Speichern.

So bearbeiten Sie eine Prozedur

1.Wählen Sie in der Prozeduren-Struktur die Prozedur aus, die Sie bearbeiten wollen.

2.Im rechten Fensterteil werden die Eigenschaften der ausgewählten Prozedur angezeigt. Bearbeitet werden können alle Parameter (außer Prozedur), die bei der Erstellung der Prozedur festgelegt wurden. Dieser Parameter kann nach der Erstellung der Prozedur nicht bearbeitet werden, da er das Ereignis bestimmt, für das die Prozedur aufgerufen werden soll.

3.Klicken Sie auf Speichern.

Prozeduren aktivieren

Durch Aktivierung einer Prozedur oder Gruppe von Prozeduren legen Sie fest, dass die Prozeduren beim festgelegten Ereignis ausgeführt werden.

So aktivieren Sie eine Prozedur oder Gruppe von Prozeduren

1.Wählen Sie in der Prozeduren-Struktur die Prozedur oder Gruppe aus, die Sie aktivieren wollen.

2.Führen Sie eine der folgenden Aktionen durch:

Klicken Sie in der Symbolleiste auf Ausführen der Prozedur erlauben.

Aktivieren Sie im rechts befindlichen Bereich der Eigenschaften des ausgewählten Objekts das Kontrollkästchen Ausführen der Prozedur erlauben, falls es deaktiviert ist. Klicken Sie auf Speichern.

Hinweise zur Aktivierung von Prozeduren

Damit eine Prozedur beim festgelegten Ereignis ausgeführt werden kann, müssen folgende Voraussetzungen erfüllt sein:

a)Die Prozedur muss aktiviert sein.

b)Die Gruppe, der die Prozedur angehört, muss ebenfalls aktiviert sein.

Falls die Gruppe deaktiviert ist, können die darin befindlichen Prozeduren nicht ausgeführt werden, selbst wenn sie aktiviert sind.

Falls die Gruppe aktiviert ist, können nur die Prozeduren ausgeführt werden, die selbst aktiviert sind.