# StattBuchung Hilfezentrum : Kalender

Created by Benedikt Wismans, last modified by Thomas Mack on Apr 14, 2018

Der Kalender als zentrale Komponente der Event App ist ja schon lange bekannt. Diese Seite beschreibt die Eigenschaften des Kalenders im Zusammenspeil mit den anderen Perspektiven und geht insbesondere auf Neuerungen und Verbesserungen ein. Das ganze ist work in progress.

# Einführung

Neben dem Kalender rechts im Bild gibt es auch die Kalenderperspektive, links im Bild mit den verschiedenen Controls. Wird die Kalenderperspektive im linken Bereich aktiviert, wird auch der Kalender in den Vordergrund geholt. Allerdings nicht umgekehrt, denn es ist üblich in einer anderen Perspektive (z.B. Events oder Produkte) zu arbeiten und nur mal schnell auf den Kalender zu schauen.

Die im Kalender dargestellten Module können auch in anderen Sichten geöffnet sein. Doppelklickt man z.B. ein Modul wird der zugehörige Event in einem neuen Tab geöffnet und auf das Modul fokussiert auf das doppelt geklickt worden ist. In dieser Situation können die meisten Funktionen des Kalenders für die Module. die in einem geöffneten Event-Tab sichtbar und bearbeitbar sind, nicht verwendet werden. Das ist eine Vorsichtsmaßnahme die ausschließt, dass sich Änderungen gegenseitig überschreiben. Diese Konfliktsituation wird allerdings immer im Tooltip des Moduls im Kalender angezeigt:

Im oben stehenden Beispiel ist der Event 07-00047 geöffnet, der Reiter liegt direkt neben dem Reiter des Kalenders. Das Modul 1828-2015... ist Teil dieses Events und ist deshalb gesperrt, worauf der Tooltip in der letzten Zeile hinweist.

Die Sperrung betrifft folgende Bearbeitungsmöglichkeiten des Moduls im Kalender:

- Ändern von Beginn- und Ende-Zeit des Moduls durch Verschieben
- Ändern der Dauer des Moduls durch Ziehen und Verändern der Länge
- Löschen des Moduls durch das Kontextmenü

Schließen Sie einfach den Tab des betreffenden Events um die Sperrung aufzuheben durch ein Klick auf das x-Symbol hinter dem Namen des Events:

Alternativ können Sie auch das Kontextmenü des Moduls im Kalender verwenden um den zugehörigen Reiter zu schließen. Das kann dann sinnvoll sein, wenn viele Events in Reitern geöffnet sind und es schwierig ist schnell den richtigen zu finden.

Danach sind alle Bearbeitungsmöglichkeiten im Kalender wieder möglich.

## Bedienung des Kalenders

Die Bedienung des Kalenders erfolgt teilweise über das Kontextmenü, das durch Anklicken und Selektieren des gewünschten Moduls mit der rechten Maustaste geöffnet wird. Um Zusammenhänge zu visualisieren werden beim Anklicken eines Moduls mit der linken Maustaste oder durch Auswahl von Events oder Produkten (siehe dazu unten) ggf. auch mehrere Module farblich selektiert. Deshalb löscht das Anklicken mit der rechten Maustaste immer alle Selektionen mit Ausnahme des Moduls auf das geklickt wurde.

### Neue Module erfassen

Klicken Sie mit gedrückter cmd- oder ctrl-Taste auf den Termin im Kalender zu dem das Modul beginnen soll. Das Beginndatum wird immer auf volle 15 Minuten voreingestellt, Beginn ist also immer 15/30/45 oder die volle Stunde. Das ist aber nur die Voreinstellung, in dem sich öffnenden Dialog können Beginn und Ende-Zeiten minutengenau überschrieben werden.

Die Rahmendaten können direkt in den sich öffnenden Dialog eingegeben werden, die Detaillierung erfolgt dann wie üblich im Event der sich als neuer Reiter öffnet, wenn das (neue) Modul doppelt angeklickt wird.

Da beim Erfassen das Produkt, auf dem das Modul basiert, noch nicht bekannt ist kann die Standarddauer des Produktes auch nicht automatisch für die Berechnung der Ende-Zeit des Moduls herangezogen werden. Standardmäßig wird deshalb ein Dauer von 30 Minuten voreingestellt, die natürlich wie oben schon dargestellt minutengenau überschrieben werden kann.

An dieser Stelle muss definiert werden, ob das neue Modul nur ein weiteres Modul eines bereits bestehenden Events ist, oder ob ein neuer Event angelegt werden soll dem dann das neue Modul als 1. Modul hinzugefügt werden soll:

#### Dieser Termin ist ein weiteres Modul dieses Events

- Steht hier Trifft nicht zu (Neuer Event wird erzeugt) passiert genau das und der Typ und der Status des neuen Events müssen ebenfalls angegeben werden. Achtung: Es können nur solche Typen ausgewählt werden, die in der Kalenderperspektive aktiv, d.h. angehakt sind. Ansonsten würde das neue Modul gar nicht im Kalender angezeigt werden, was nicht sehr sinnvoll ist. Falls die Option Separate Spalten angehakt ist, kann der Typ des Events nicht ausgewählt werden sondern dieser ist bereits voreingestellt auf den Typ der Spalte, in die geklickt worden ist.
- Ansonsten muss hier der Event ausgewählt werden zu dem das neue Modul zugeschlagen werden soll. In diesem Fall sind Typ und Status grau hinterlegt und können ignoriert werden.

Die weiteren Attribute dieses Dialogs sind selbsterklärend.

In den Kalenderoptionen kann eingestellt werden, dass auch ein Klick ohne gedrückte Meta-Taste ein neues Modul erzeugt.

### Ein bestehendes Modul löschen

Klicken Sie mit der rechten Maustaste auf das Modul um das Kontextmenü zu öffnen und wählen Sie die Option Modulename löschen. Dadurch wird das Modul ohne weitere Nachfrage inklusive aller bereits vorgenommenen Konfigurationen gelöscht.

Diese Funktion steht nicht zur Verfügung wenn das Modul gesperrt ist, in diesem Fall ist der Eintrag im Kontextmenü grau hinterlegt und nicht wählbar.

### Verschieben des Moduls auf einen anderen Termin (Beginn und Ende setzen)

Fahren Sie mit der Maus über das Modul. Dadurch ändert sich der Mauszeiger zu einem Verschiebe-Symbol, einem Kreuz mit Spitzen in alle 4 Richtungen. Klicken Sie mit der linken Maustaste auf das Modul und ziehen Sie es an eine andere Stelle. Dadurch werden Beginn- und Ende-Zeit/Datum gleichzeitig geändert. Beim Verschieben sehen Sie Änderung auf die neue Beginn-Zeit im oberen Bereich des Modulsymbols, im Beispiel 10:30:

Wie beim Anlegen springt die Zeit im 15-Minuten-Raster. Durch das Verschieben kann das Modul also nur auf Termine gelegt werden, die auf 15/30/45 oder der vollen Stunde liegen. Wie bereits oben beschrieben kann das aber im Event-Tab minutengenau überschrieben werden.

Diese Funktion steht nicht zur Verfügung wenn das Modul gesperrt ist. Da sich in diesem Fall der Mauszeiger nicht ändert wird klar dass das Verschieben nicht aktiv ist.

### Ändern der Dauer eines Moduls

Fahren Sie mit der Maus über den Beginn (oberer Bereich) oder das Ende (unterer Bereich) des Modulsymbols. Dadurch ändert sich das Mauszeiger in ein Verschiebe-Symbol, einem vertikalen Pfeil. Klicken Sie mit der linken Maustaste und ziehen Sie den Beginn oder das Ende des Modulsymbols nach oben oder unten. Dabei werden im oberen und unteren Bereich die Beginn- und Ende-Zeit eingeblendet.

Wie beim Anlegen springt die Zeit im 15-Minuten-Raster. Durch das Ziehen kann das Modul also nur auf Termine gelegt werden, die auf 15/30/45 oder der vollen Stunde liegen oder enden. Wie bereits oben beschrieben kann das aber im Event-Tab minutengenau überschrieben werden.

Diese Funktion steht nicht zur Verfügung wenn das Modul gesperrt ist. Da sich in diesem Fall der Mauszeiger nicht ändert wird klar dass das Ziehen nicht aktiv ist.

### Duplizieren eines bestehenden Moduls

Klicken Sie mit der rechten Maustaste auf das Modul um das Kontextmenü zu öffnen und wählen Sie die Option Modulename duplizieren. Dadurch wird das Modul ohne weitere Nachfrage dupliziert. Das Duplikat ist mit Ausnahme der Mitarbeiterzuordnung identisch zum Original. Es ist naheliegend, dass die Mitarbeiterzuordnung für das Duplikat ergänzt werden muss, schließlich ist das Duplikat zeitgleich zum Original und die im Original zugeordneten Mitarbeiter stehen für die Betreuung des Duplikats nicht zur Verfügung.

Original und Duplikat teilen sich den Platz im Kalender, wobei sie an der linken Seite unterschiedliche Einrückungen haben so dass man beide mit der Maus erreichen kann:
Nach dem Duplizieren können Original und Duplikat natürlich unabhängig von einander verändert werden.

Diese Funktion steht nicht zur Verfügung wenn das Modul gesperrt ist, in diesem Fall ist der Eintrag im Kontextmenü grau hinterlegt und nicht wählbar.

### Modul zum Bearbeiten öffnen

Klicken Sie mit der rechten Maustaste auf das Modul um das Kontextmenü zu öffnen und wählen Sie Modulname in neuem Reiter öffnen oder doppelklicken Sie auf ein Modul. Daraufhin öffnet sich der Event zu dem das Modul gehört in einem neuen Reiter. Neu ist, dass die Event-Ansicht in diesem Fall automatisch auf das in der Kalenderperspektive gewählte Modul fokussiert. Damit entfällt ein weiterer Mausklick.

Falls das Modul bereits geöffnet ist lautet der Eintrag im Kontextmenü Zugehörigen Reiter einblenden. In diesem Fall wird das Modul nicht erneut geladen sondern der Reiter des Moduls wird lediglich in den Vordergrund geholt.

Diese Funktion steht immer zur Verfügung. Ist der Event aber schon in einem Tab geöffnet, bewirkt der Doppelklick nur dass dieser Tab in den Vordergrund geholt wird, der Focus wird nicht angepasst. Das ist deshalb sinnvoll, da der Nutzer den Focus ja schon an die Stelle gesetzt hat, die er bearbeiten möchte, so dass das automatische Setzen des Focus auf das Modul diese Arbeit zunichte machen würde.

### Zugehörigen Event-Reiter schließen

Klicken Sie mit der rechten Maustaste auf das Modul um das Kontextmenü zu öffnen und wählen Sie Zugehörigen Reiter schließen. Diese Funktion kann nur ausgewählt werden wenn es wirklich einen zugehörigen Event-Reiter gibt. Alternativ kann der Reiter natürlich auch einfach durch Anklicken des x-Symbols neben dem Reiternamen geschlossen werden.

## Die Kalenderperspektive

Die Kalenderperspektive hat 3 Bereiche: Datepicker, die Kalenderoptionen und Veranstaltungen und Programme.

### Datepicker

Der Datepicker ist eine Hilfe um den Kalender schnell bedienen zu können, denn der Kalender wird immer auf das Datum gesetzt das im Datepicker angeklickt wurde, natürlich unter Berücksichtigung des angezeigten Ansicht. Wenn also im Kalender die Wochenansicht eingestellt ist, wird die Woche eingeblendet, in der der tag liegt, der im Datepicker angeklickt wurde. Für die Tagesansicht ist das trivial, die anderen Ansichten verhalten sich analog.

Gleichzeitig visualisiert der Datepicker den Datumsbereich der im Kalender angezeigt wird, z.B. 4 Tage:

### Kalenderoptionen

#### von / bis / Anwenden und neu laden

Standardmäßig werden Module bis zu einem Jahr in der Vergangenheit und bis zu einem Jahr in die Zukunft geladen. Dieses Verhalten kann hier geändert werden. Nach Änderung der Datumsgrenzen muss der Button angeklickt werden.

#### Separate Spalten (default aus)

Mit dieser Option werden die Kalendereinträge für jeden Tag in so vielen Spalten angezeigt wie es angehakte Veranstaltungen und Programme gibt:

Dadurch wird die Übersichtlichkeit erhöht, allerdings nicht bei großen Zeiträumen.

#### Tooltips anzeigen (default ein)

Zu jedem Modul wird eine Zusammenfassung als Tooltip angezeigt.

#### cmd/alt-Klick fügt ein (default ein)

Ist diese Option angehakt muss die cmd- oder alt-Taste gedrückt sein wenn mit einem Klick auf den Kalender ein neues Modul angelegt werden soll. Ansonsten wird bei jedem Klick der Dialog zur Erfassung eines neuen Moduls geöffnet.

### Veranstaltungen und Programme

In dieser Liste werden alle Typen von Events dargestellt. Der Haken vor dem Eintrag besagt, ob die Module der Events dieses Typs im Kalender angezeigt werden sollen oder nicht. Nach dem Ändern ist es nicht notwendig, den Kalender neu zu laden. Es werden immer alle Module geladen, die Haken bestimmen nur die Sichtbarkeit. Falls neue Module angelegt werden, die zu einem neuen Event gehören, können nur solche Typen von Events ausgewählt werden, die in dieser Liste angeklickt sind. Hintergrund ist, dass das Anlegen von Modulen zu Events, die nicht sichtbar sind, den Nutzer verwirren würden, denn nach dem Anlegen wäre das neue Modul "verschwunden".

## Funktionen des Kalenders in Bezug auf Events, Produkte und Module

Die Darstellungsebene des Kalenders sind keine Events, sondern Module, also Instanzen von Produkten, die konkret angeboten werden. Produkte sind also die Typ-Ebene, ein Produkt kann man nicht buchen oder anbieten, wohl aber ein Modul auf Basis des Produktes. Jeder Event besteht aus mindestens einem Modul, natürlich können es auch mehr sein. Diese Zusammenhänge finden sich auch auf der Oberfläche wieder, und zwar im Kalender und im Zusammenspiel des Kalenders mit anderen Perspektiven.

### Identifikation zusammengehöriger Module im Kalender

Ein Einfachklick auf ein Modul selektiert dieses, d.h. es wird in einer anderen Farbe, der Auszeichnungsfarbe, dargestellt. Gleichzeitig werden alle anderen Module des gleichen Events ebenfalls in dieser Farbe dargestellt. Es ist also sofort ersichtlich, welche Module der Event umfasst. In dem hier verwendeten Farbschema ist die Auszeichnungsfarbe schwarz.

In der letzten Spalte (23.07.17) sind 2 Module schwarz eingefärbt, obwohl natürlich nur auf ein Modul geklickt worden ist. Beides sind Module des gleichen Events.

### Module eines Events im Kalender anzeigen

Der gleiche Effekt stellt sich ein, wenn ein Event aus der Event-Perspektive im Baum angeklickt wird: Alle Module des Events werden im Kalender eingefärbt.

Im Tooltip zum Event ist die Dauer über alle Module angegeben, also von 07:15 bis 12:30. Es ist also unmittelbar.

Umgekehrt funktioniert das natürlich auch: Wenn ein Modul im Kalender angeklickt wird, wird der zugehörige Event in allen Suchergebnissen der Event-Perspektive farblich selektiert, allerdings scrollt der Baum nicht automatisch. Es kann also sein dass erst auf die richtige Position gescrollt werden muss damit die farbliche Selektion sichtbar wird.

### Alle Module finden, die das gleiche Produkt verwenden

Wird in der Produktperspektive auf ein Produkt im Suchergebnis geklickt werden alle Module im Kalender, die dieses Produkt verwenden, eingefärbt:

Auch das funktioniert auch anders herum: Wird ein Modul im Kalender angeklickt, wird das zugehörige Produkt in allen Suchergebnissen der Produktperspektive farblich selektiert, allerdings scrollt der Baum nicht automatisch. Es kann also sein dass erst auf die richtige Position gescrollt werden muss damit die farbliche Selektion sichtbar wird.

## Kalender konfigurieren

### Neuen Kalender hinzufügen

Die Kalender im Eventmanager stellen alle verfügbaren Veranstaltungstypen dar. Um einen neuen Kalender anzulegen fügen Sie in den Voreinstellungen einen neuen Veranstaltungstyp hinzu.

### Kalender beim Start aktiv schalten

Um für einen bestimmten Kalender festzulegen, ob dieser inital angezeigt wird tragen Sie bei der Beschreibung im Admin-Bereich das Wort "aktiviert" ein. Bitte beachten Sie die Groß- und Kleinschreibung.

### Farbe des Kalenders anpassen

Die Kalenderfarben können Sie aus 216 Websicheren Farben wählen. Dazu müssen Sie in der Beschreibung des Veranstaltungstyps den Text "color:#FFCCFF" eintragen. Wobei nach der # der jeweilige Farbcode steht.

Diesen können Sie z.B. aus folgender Tabelle ermitteln http://www.css4you.de/refcolor216.html

## Attachments:

image2017-7-23 15:9:42.png (image/png)
image2017-7-23 15:22:11.png (image/png)
image2017-7-23 15:27:40.png (image/png)
image2017-7-23 15:40:51.png (image/png)
image2017-7-23 15:45:59.png (image/png)
image2017-7-23 15:47:50.png (image/png)
image2017-7-23 15:55:3.png (image/png)
image2017-7-23 15:56:1.png (image/png)
image2017-7-23 16:9:0.png (image/png)
image2017-7-23 16:12:35.png (image/png)
image2017-7-23 16:18:44.png (image/png)
image2017-7-23 16:22:34.png (image/png)
image2017-7-23 16:24:47.png (image/png)
image2017-7-24 12:44:1.png (image/png)
image2017-7-24 13:7:17.png (image/png)
image2017-7-24 13:22:58.png (image/png)
image2017-7-24 13:25:15.png (image/png)
image2017-7-24 13:29:12.png (image/png)
image2017-7-24 13:29:56.png (image/png)
image2017-7-24 13:42:11.png (image/png)
image2017-7-24 14:9:20.png (image/png)
image2017-7-24 14:11:46.png (image/png)
image2017-7-26 10:53:15.png (image/png)
image2017-7-26 10:53:44.png (image/png)
image2017-7-26 10:57:39.png (image/png)
image2017-7-26 11:8:47.png (image/png)
image2017-7-26 11:12:21.png (image/png)
image2017-7-26 11:13:1.png (image/png)
image2017-7-26 11:14:13.png (image/png)
image2018-3-11 8:5:7.png (image/png)