From 515836a9fe7fb5756f23b43c308ad23a577f8d30 Mon Sep 17 00:00:00 2001 From: Christian Hofmaier Date: Sun, 19 May 2019 18:08:01 +0000 Subject: [Documentation] Add Eventmanager Module --- documentation/de/webapp/modules.md | 57 ++++++++++++++++++++++++++++++++++++++ documentation/webapp/modules.md | 56 +++++++++++++++++++++++++++++++++++++ 2 files changed, 113 insertions(+) (limited to 'documentation') diff --git a/documentation/de/webapp/modules.md b/documentation/de/webapp/modules.md index ab20c71..2d8c48e 100644 --- a/documentation/de/webapp/modules.md +++ b/documentation/de/webapp/modules.md @@ -5,6 +5,63 @@ ## iPXE Konfigurator ## Client Registrierung ## Eventverwaltung +Dieses Modul liefert eine Übersichtstabelle von allen Veranstaltungen. + +BAS Event Manager + +Wird eine Veranstaltung erstellt 1 oder bearbeitet 2, so öffnet sich ein Dialog mit allen einstellbaren Optionen. +Ausgewählte Veranstaltungen können über den ```Löschen```-Button 3 entfernt werden. + +Um eine Veranstaltung zu erstellen müssen allgemeine Einstellungen vorgenommen werden (Schritt 1), Gruppen und/oder Clients zugewiesen werden (Schritt 2) und optional eine Blacklist von Subgruppen und/oder Clients erstellt werden. +::: warning WARNUNG +Eine Veranstaltung kann bereits ohne zugewiesenen Gruppen erstellt werden, muss dann allerdings nachträglich editiert werden. +::: + +### Allgemeine Einstellungen +BAS Event Manager Dialog + +> 1 - Wähle eine Konfiguration, die während der laufenden Veranstaltung gebootet werden soll. \ +> 2 - Wähle diese Option, wenn die Veranstaltung Priorität gegenüber anderen Veranstaltungen haben soll. \ +> 3 - Wähle diese Option, wenn Wake-On-Lan zu Beginn der Veranstaltung für alle zugewiesenen Gruppen und Clients ausgeführt werden soll. \ +> 4 - Setze Beginn und Ende der Veranstaltung. \ +> 5 - Erstelle eine periodische Veranstaltung. + +::: warning WARNUNG +Mehrere, als ```important``` makierte, Veranstaltungen auf der selben Ebene lösen die Erstellung eines dynamischen Menüs aus (siehe [Configloader](/api/collections.md#configloader)). +::: + +#### Periodische Veranstaltungen +BAS Event Manager Dialog + +> 1 - Wähle an welchen Tagen die Veranstaltung stattfindet. Standard: Alle ausgewählt. \ +> 2 - Wähle in welchen Monaten die Veranstaltung stattfindet. Standard: Alle ausgewählt. \ +> 3 - Setze das Intervall. \ +> 4 - Wähle den Typ des Intervalls. Optionen sind: ```Tag```, ```Woche``` und ```Monat```. + +::: warning WARNUNG +Durch die Änderung auf eine periodische Veranstaltung wird die Bedeutung der ausgewählten Zeiten und Tage geändert. +Startdatum und Enddatum sind nun der erste und letzte mögliche Tag der Veranstaltung und die Veranstaltung findet nun von Startzeit bis Endzeit an jedem durch das Intervall bestimmten Tag statt. +::: + +::: tip TIPP +Intervalltyp 4 ```Woche``` bestimmt, dass die Veranstaltung die gesamte Woche stattfindet, während ```Monat``` lediglich das Startdatum jeden Monat ist. +Z.B. wählt man den 13. Januar als Startdatum aus und ```1, Monat``` als Intervall, so findet die Veranstaltung am 13ten jeden Monats zwischen Startdatum und Enddatum statt, mit Ausnahme der nicht ausgewählten Monate in 2. +Wählt man ```2, Woche``` als Intervall, so findet die Veranstaltung jede 2te Woche statt, die Woche des Startdatums als erste Woche mit laufender Veranstaltung. +::: + +### Gruppen und Clients +BAS Event Manager Dialog + +Gruppen 1 und Clients 2, die von der Veranstaltung betroffen sind, müssen ausgwählt werden. +Das Auswählen einer Gruppe aktiviert den ```WEITER```-Button. + +Die Blacklist zeigt nur Subgruppen und Clients der zuvor ausgewählten Gruppen. +Die Liste wird genutzt, um Gruppen und Clients auszuwählen, die von der Veranstaltung ausgenommen werden sollen. + +::: warning WARNUNG +Wenn eine zuvor ausgewählte Gruppe innerhalb einer geblacklisteten Gruppe ist wird die zuvor ausgewählte Gruppe nicht von der Veranstaltung ausgeschlossen. +::: + ## Externe Backends ## Rechtemanager ## iPXE Builder diff --git a/documentation/webapp/modules.md b/documentation/webapp/modules.md index 77ee29e..716936e 100644 --- a/documentation/webapp/modules.md +++ b/documentation/webapp/modules.md @@ -4,6 +4,62 @@ ## IP Ranges ## iPXE Configurator ## Event Manager +This module provides an overview table of all existing events. + +BAS Event Manager + +An event can be created 1 or edited 3, which opens a dialog with all configurable options. +Selected events can be deleted by using the ```DELETE``` button 2. + +To create an event general options must be set (Step 1), groups and/or clients must be assigned (Step 2) and optionally a blacklist of subgroups and/or clients can be created (Step 3). +::: warning +The event can be created right away without assigning any group, but then has to be edited later on. +::: + +### General Options +BAS Event Manager Dialog + +> 1 - Choose one of the existing configurations which will be booted while the event is live. \ +> 2 - Enable this option, if the event has priority over other ongoing events. \ +> 3 - Enable this option, if Wake-On-Lan shall be triggered for all assigned groups and clients at the start of the event. \ +> 4 - Set start and end of the event. \ +> 5 - Enable to create an recurrent event. + +::: warning +Multiple ```important``` events on the same layer trigger dynamic menu building (see [Configloader](/api/collections.md#configloader)). +::: + +#### Recurrent Events +BAS Event Manager Dialog + +> 1 - Select on which days the event is happening. Default: all selected. \ +> 2 - Select in which months the event is happening. Default: all selected. \ +> 3 - Set the interval. \ +> 4 - Select the type of the interval. Options are ```days```, ```weeks``` and ```months```. + +::: warning +Activating the recurrent switch changes from an one-time event to an recurrent event, therefore changing the meaning of start date/time and end date/time. +The dates are now referring to the first and the last date of the event, with the event ongoing from start to end time at every day determined by the interval. +::: + +::: tip +Intervaltype 4 ```week``` means the event is ongoing for the whole week, while ```month``` is only the start date in the month. +E.g. choosing the 13th of january as the start date and ```1, month``` as interval will set up the event on the 13th of every month between start and end date with exception of the non-selected months in 2. +While for ```2, week``` as interval the event is ongoing every 2nd week with the start date being in the first ongoing week. +::: + +### Groups and Clients +BAS Event Manager Dialog + +Groups 1 and/or clients 2 which are affected by the event have to be selected. +Selecting a group will activate the ```CONTINUE``` button. + +The blacklist only shows subgroups and clients of the previously selected groups. +The list is used for selecting groups and clients which shall be excluded of the event. + +::: warning +If a previously selected group is inside of a blacklisted group, the previously selected group is not excluded from the event. +::: ## Client Registration ## External Backends -- cgit v1.2.3-55-g7522