Florian WildeandClaude Opus 5
a8b2ff0235
Die Handbuchseite erklärt, was der Planer liest und was ausdrücklich nicht, warum alle Kalender gegen jeden Bereich zählen und was beim Trennen mit den Terminen passiert. Die README bekommt eine Schritt-für-Schritt-Anleitung für Entra ID und die Google Cloud Console — mit den genauen Rückleit-URIs und Berechtigungen. Dazu der Hinweis, dass ein Google-Projekt im Status "Test" die Aktualisierungstoken nach sieben Tagen verfallen lässt; das kostet sonst einen halben Abend Fehlersuche. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
117 lines
5.8 KiB
Markdown
117 lines
5.8 KiB
Markdown
# Kalenderkonten verbinden
|
|
|
|
Der Planer liest deine Termine, um zu wissen, **wann überhaupt Platz ist**.
|
|
Ab M4 schreibt er Zeitblöcke in denselben Kalender zurück.
|
|
|
|
|
|
|
|
## Was der Planer liest — und was nicht
|
|
|
|
| Liest er | Nutzt er wofür |
|
|
| --------------------------------- | ------------------------------------------------ |
|
|
| Beginn und Ende | Belegung gegen die Tageskapazität |
|
|
| Betreff | Anzeige in der Wochenansicht |
|
|
| Ganztägig ja/nein | Ganztägige Termine zählen **nicht** zur Belegung |
|
|
| „Zeigt an als" (frei, gebucht, …) | Als frei markierte Termine zählen nicht |
|
|
|
|
**Nicht gelesen** werden Teilnehmer, Beschreibungstexte, Anhänge und Orte.
|
|
Betreffs stehen in der Datenbank, damit du sie in der Ansicht siehst — sie
|
|
landen aber **niemals in Protokollen**.
|
|
|
|
Gelesen wird ein Fenster von **7 Tagen zurück bis 90 Tage voraus**. Was aus
|
|
diesem Fenster herauswandert, wird nachts wieder entfernt.
|
|
|
|
## Einen Kalender verbinden
|
|
|
|
1. Im Menü auf **Kalender**.
|
|
2. Auf **Microsoft 365 verbinden** beziehungsweise **Google verbinden**.
|
|
3. Beim Anbieter anmelden und der Berechtigung zustimmen.
|
|
4. Du landest wieder hier, und der erste Abgleich läuft sofort.
|
|
|
|
> **Warum fragt der Planer auch nach Schreibrechten?** Weil er ab M4
|
|
> Zeitblöcke in den Kalender schreibt. Würde er jetzt nur Leserechte
|
|
> anfordern, müsstest du später jedem Konto erneut zustimmen — und genau
|
|
> daran scheitert Einrichtung erfahrungsgemäß.
|
|
|
|
### Welche Anbieter es gibt
|
|
|
|
Das hängt an der Instanz und ist nicht verhandelbar:
|
|
|
|
| | Firma | Daheim |
|
|
| ------------- | -------- | ------ |
|
|
| Microsoft 365 | ja | ja |
|
|
| Google | **nein** | ja |
|
|
|
|
In der Firmeninstanz gibt es die Google-Seite nicht — der Aufruf endet dort
|
|
mit „Diese Seite gibt es nicht". Das ist Absicht, kein Fehler.
|
|
|
|
## Der Abgleich
|
|
|
|
Alle 15 Minuten läuft der Abgleich von selbst. Mit **Jetzt abgleichen**
|
|
stößt du ihn von Hand an.
|
|
|
|
Beide Anbieter liefern nur die **Änderungen** seit dem letzten Mal, nicht
|
|
jedes Mal alle Termine. Läuft dieser Merker ab — das passiert nach längerer
|
|
Pause —, liest der Planer den ganzen Zeitraum neu ein. Davon merkst du außer
|
|
einem etwas längeren Abgleich nichts.
|
|
|
|
## Die Belegung
|
|
|
|
Auf der Startseite zeigt jeder Bereich, wie voll der heutige Tag schon ist:
|
|
Termine aus **allen** verbundenen Kalendern gegen die Tageskapazität dieses
|
|
Bereichs.
|
|
|
|
> **Warum zählen alle Kalender gegen jeden Bereich?** Weil ein Termin die
|
|
> Zeit ohnehin blockiert, ganz gleich, zu welchem Lebensbereich er gehört.
|
|
> Wer um 14 Uhr beim Zahnarzt sitzt, kann zur selben Zeit nichts für die
|
|
> Firma tun.
|
|
|
|
Gezählt wird nur, was **ins Arbeitsfenster** des Bereichs fällt. Ein Termin
|
|
um 22 Uhr verkleinert die Kapazität eines Bereichs nicht, dessen Fenster um
|
|
17 Uhr endet.
|
|
|
|
Überlappende Termine werden zusammengelegt — eine Doppelbuchung zählt nur
|
|
einmal.
|
|
|
|
## Ein Konto umbenennen
|
|
|
|
Die Bezeichnung ist frei wählbar. „Firma Outlook" oder „Gewerbe" liest sich
|
|
besser als die Mailadresse, gerade wenn du mehrere Konten desselben
|
|
Anbieters hast.
|
|
|
|
## Ein Konto trennen
|
|
|
|
Der rote Knopf, mit Rückfrage. Die gespiegelten Termine verschwinden dabei —
|
|
**im Kalender selbst bleibt alles unangetastet**. Der Planer hat bis M4
|
|
ohnehin nur gelesen.
|
|
|
|
Zusätzlich solltest du die Berechtigung beim Anbieter selbst zurückziehen:
|
|
|
|
- Microsoft: <https://myapps.microsoft.com> → _Zugriff verwalten_
|
|
- Google: <https://myaccount.google.com/permissions>
|
|
|
|
## Wenn es klemmt
|
|
|
|
| Was du siehst | Was dahintersteckt |
|
|
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
| „Der Anbieter hat kein Aktualisierungstoken herausgegeben." | Meist bei Google, wenn du schon einmal zugestimmt hattest. Berechtigung im Google-Konto entziehen und neu verbinden. |
|
|
| „Die Anfrage war ungültig oder zu alt." | Zwischen Klick und Zustimmung lagen mehr als 30 Minuten. Einfach neu beginnen. |
|
|
| „Kein Aktualisierungstoken hinterlegt." | Das Konto muss neu verbunden werden. Das passiert auch, wenn `AUTH_SECRET` gewechselt wurde. |
|
|
| „Der Anbieter antwortete mit 401." | Die Berechtigung wurde beim Anbieter entzogen. Neu verbinden. |
|
|
| „unerwartete Zeitzone …, erwartet wurde UTC" | Ein Konfigurationsfehler auf Serverseite. Bitte melden — der Planer bricht hier bewusst ab, statt Termine um Stunden zu verschieben. |
|
|
| Die Belegung bleibt leer | Kein Kalender verbunden, oder der erste Abgleich lief noch nicht. Die Karte zeigt die Belegung erst, wenn wirklich ein Kalender dranhängt. |
|
|
|
|
## Sicherheit
|
|
|
|
Die Zugangstoken liegen **verschlüsselt** in der Datenbank (AES-256-GCM).
|
|
Wer eine Sicherung in die Hände bekommt, kann damit nichts anfangen, solange
|
|
er nicht auch `AUTH_SECRET` hat.
|
|
|
|
Wird `AUTH_SECRET` gewechselt, müssen alle Kalenderkonten neu verbunden
|
|
werden. Das ist gewollt: mit dem alten Geheimnis sind auch alle Sitzungen
|
|
ungültig.
|
|
|
|
Für die Einrichtung auf Serverseite — was in Entra ID und in der Google
|
|
Cloud Console anzulegen ist — siehe
|
|
[README, Abschnitt Kalenderanbieter](../../README.md#kalenderanbieter-einrichten).
|