Kalender-Synchronisation

Synchronisieren Sie Ihren Octoserv-Kalender mit Google Calendar, Microsoft Outlook oder Nextcloud/CalDAV. Termine werden automatisch in beide Richtungen abgeglichen – so haben Sie immer den aktuellen Stand, egal welches System Sie nutzen.

Unterstützte Kalender

Einrichtung durch den Administrator

Bevor Mitarbeiter ihre Kalender verbinden können, muss ein Administrator die Anbindung an Google und/oder Microsoft einmalig konfigurieren. Für CalDAV ist keine Administrator-Einrichtung erforderlich.

Zeitzone einstellen

Stellen Sie als erstes die korrekte Zeitzone ein. Öffnen Sie dazu Einstellungen → Kalender-Sync und wählen Sie im Dropdown Ihren Standort aus (z. B. „Deutschland (Berlin)“). Damit werden alle Termine mit der richtigen Uhrzeit synchronisiert – einschließlich automatischer Sommer-/Winterzeit-Umstellung.

Google Calendar einrichten

1. Google Cloud Console öffnen: Rufen Sie https://console.cloud.google.com auf und melden Sie sich mit dem Google-Konto Ihrer Organisation an.
2. Neues Projekt erstellen: Klicken Sie oben auf die Projektauswahl und dann auf „Neues Projekt“. Vergeben Sie einen aussagekräftigen Namen, z. B. „Firmenname Octoserv“.
3. Google Calendar API aktivieren: Navigieren Sie zu APIs und Dienste › Bibliothek. Suchen Sie nach „Google Calendar API“ und klicken Sie auf „Aktivieren“.
4. OAuth-Zustimmungsbildschirm konfigurieren: Gehen Sie zu APIs und Dienste › OAuth-Zustimmungsbildschirm.
   • Nutzertyp: Extern
   • App-Name: z. B. „Firmenname Octoserv“
   • Support-E-Mail: E-Mail-Adresse des Administrators
   • Autorisierte Domains: Die Domain Ihrer Octoserv-Installation
5. Berechtigungen hinzufügen: Fügen Sie den Bereich https://www.googleapis.com/auth/calendar hinzu.
6. Anmeldedaten erstellen: Navigieren Sie zu APIs und Dienste › Anmeldedaten und klicken Sie auf „+ Anmeldedaten erstellen“ › „OAuth-Client-ID“.
   • Anwendungstyp: Webanwendung
   • Autorisierte Weiterleitungs-URIs: Tragen Sie die Redirect-URI ein, die in Octoserv unter Einstellungen › Kalender-Sync angezeigt wird.
7. Client-ID und Client-Secret kopieren: Nach dem Erstellen werden Client-ID und Client-Secret angezeigt. Kopieren Sie beide Werte.
8. In Octoserv eintragen: Öffnen Sie in Octoserv Einstellungen › Kalender-Sync, tragen Sie Client-ID und Client-Secret im Bereich Google Calendar ein und klicken Sie auf „Speichern“.

Wichtiger Hinweis: Bis Google die App verifiziert hat, sehen Benutzer beim Verbinden die Warnung „App nicht verifiziert“. Um während der Testphase fortzufahren, klicken Sie auf „Erweitert“ und dann auf „Weiter zu [App-Name]“.

Microsoft Outlook einrichten

1. Azure Portal öffnen: Rufen Sie https://portal.azure.com auf und melden Sie sich mit dem Administrator-Konto Ihrer Organisation an.
2. App-Registrierungen suchen: Geben Sie in der Suchleiste oben „App-Registrierungen“ ein und öffnen Sie den Dienst.
3. Neue Registrierung anlegen: Klicken Sie auf „+ Neue Registrierung“.
4. Name vergeben: z. B. „Firmenname Octoserv“
5. Unterstützte Kontotypen wählen: Wählen Sie „Konten in einem beliebigen Organisationsverzeichnis und persönliche Microsoft-Konten“.
   WICHTIG: Diese Einstellung ist zwingend erforderlich, damit die Anmeldung korrekt funktioniert.
6. Umleitungs-URI eintragen:
   • Plattform: Web
   • URI: Die Redirect-URL, die in Octoserv unter Einstellungen › Kalender-Sync angezeigt wird.

   WICHTIG: Die Redirect-URI darf keine Fragezeichen oder Parameter enthalten! Azure lehnt URLs mit Query-Strings ab.

7. Registrieren klicken.
8. Manifest prüfen: Navigieren Sie zum Punkt „Manifest“ und stellen Sie sicher, dass "accessTokenAcceptedVersion" auf 2 steht (nicht null). Falls der Wert null ist, ändern Sie ihn auf 2 und speichern Sie.
9. Geheimen Client-Schlüssel erstellen: Gehen Sie zu Zertifikate & Geheimnisse › Neuer geheimer Clientschlüssel. Vergeben Sie eine Beschreibung und klicken Sie auf „Hinzufügen“.
   WICHTIG: Kopieren Sie den Wert sofort – er wird nur einmal angezeigt und ist danach nicht mehr abrufbar!
10. API-Berechtigungen hinzufügen: Navigieren Sie zu API-Berechtigungen › Berechtigung hinzufügen › Microsoft Graph › Delegierte Berechtigungen und fügen Sie folgende Berechtigungen hinzu:
    • Calendars.ReadWrite
    • offline_access
11. In Octoserv eintragen: Öffnen Sie in Octoserv Einstellungen › Kalender-Sync, tragen Sie die Anwendungs-ID (Client-ID) und den geheimen Clientschlüssel im Bereich Microsoft Outlook ein und klicken Sie auf „Speichern“.

CalDAV (Nextcloud, ownCloud, etc.)

Für CalDAV-Verbindungen ist keine Administrator-Einrichtung erforderlich. Jeder Mitarbeiter gibt seine eigene CalDAV-Server-URL, seinen Benutzernamen und sein Passwort direkt in Octoserv ein.

Kalender verbinden (für Mitarbeiter)

Nachdem der Administrator die Anbindung eingerichtet hat (Google/Outlook), können Mitarbeiter ihren persönlichen Kalender verbinden.

Google Calendar verbinden

1. Öffnen Sie den Bereich Termine.
2. Klicken Sie auf das Zahnrad-Symbol (Kalender konfigurieren).
3. Klicken Sie auf „Mit Google Calendar verbinden“.
4. Wählen Sie Ihr Google-Konto aus und erlauben Sie den Zugriff.
5. Wählen Sie den gewünschten Kalender aus der Liste.
6. Wählen Sie den Sync-Modus (Bidirektional empfohlen).
7. Klicken Sie auf „Verbinden“.

Microsoft Outlook verbinden

1. Öffnen Sie den Bereich Termine.
2. Klicken Sie auf das Zahnrad-Symbol (Kalender konfigurieren).
3. Klicken Sie auf „Mit Outlook verbinden“.
4. Melden Sie sich mit Ihrem Microsoft-Konto an und erlauben Sie den Zugriff.
5. Wählen Sie den gewünschten Kalender aus der Liste.
6. Wählen Sie den Sync-Modus (Bidirektional empfohlen).
7. Klicken Sie auf „Verbinden“.

CalDAV / Nextcloud verbinden

1. Öffnen Sie den Bereich Termine und klicken Sie auf das Zahnrad-Symbol.
2. Im Bereich „CalDAV verbinden“:
   • CalDAV-URL eingeben (z. B. https://cloud.meinefirma.de/remote.php/dav)
   • Benutzername eingeben
   • Passwort eingeben (oder App-Passwort, falls Zwei-Faktor-Authentifizierung aktiv ist)
3. Klicken Sie auf „Verbinden“.
4. Wählen Sie den gewünschten Kalender aus der Liste.
5. Wählen Sie den Sync-Modus.

Sync-Modi erklärt

Farbkodierung

Häufige Fragen