Microsoft 365 Kalender

OBS gleicht die Termine eines Sachbearbeiters mit einem Kalender in Microsoft 365 (Exchange Online) ab, in beide Richtungen. Die Verbindung läuft über Microsoft Graph. Für einen eigenen Exchange-Server im Haus verwenden Sie weiterhin die Exchange-Terminsynchronisation.

HINWEIS: Es handelt sich um ein kostenpflichtiges Modul. Das Modul Cloud: Microsoft 365 Termine muss über den OBS-Support aktiviert werden. Außerdem muss der OBS-Cloud-Dienst im OBS Service Manager aktiv sein.

Steckbrief
Cloud Typ	Microsoft 365 Kalender-Sync (Graph)
Richtung	OBS und Microsoft 365, beide Richtungen
Übertragungsweg	OBS-Cloud-Dienst über Microsoft Graph
Anmeldung	OAuth2 mit der Definition OAUTH2 Microsoft Graph(Outlook/Exchange)
Übersicht	Cloud-Schnittstellen

Voraussetzungen

Das Postfach liegt in Exchange Online, also in Microsoft 365 mit einer Exchange-Online-Lizenz. Postfächer auf einem eigenen Exchange-Server kann Microsoft Graph nicht bedienen.
Im Microsoft-Entra-Portal ist eine App-Registrierung mit Anwendungs-ID und geheimem Clientschlüssel eingerichtet, siehe oAuth2-Authentifizierung.

Einrichtung

OAuth2-Eintrag

Den OAuth2-Eintrag legen Sie einmal an und verwenden ihn für alle Kalender-Konten.

Öffnen Sie Stammdaten → Z Weitere Stammdaten → Cloud Connect und legen Sie mit Einfg einen neuen Eintrag an.
Wählen Sie bei Cloud Typ die Definition OAUTH2 Microsoft Graph(Outlook/Exchange).
Tragen Sie bei App ID die Anwendungs-ID und bei App Secret ID den Wert des geheimen Clientschlüssels ein.
Sichern Sie mit F2.

Kalender-Konto

Legen Sie für jeden Sachbearbeiter, dessen Termine abgeglichen werden sollen, ein eigenes Kalender-Konto an.

Legen Sie in Cloud Connect mit Einfg einen neuen Eintrag an.
Wählen Sie bei Cloud Typ Microsoft 365 Kalender-Sync (Graph) und vergeben Sie einen Titel, z.B. Termine Anna B..
Wählen Sie bei oAuth2 Connect den OAuth2-Eintrag und setzen Sie das Häkchen Aktiv.
Drücken Sie F10. Ihr Browser öffnet sich. Melden Sie sich mit dem Microsoft-365-Konto an, dessen Kalender abgeglichen werden soll, und bestätigen Sie den Zugriff. Verlangt Microsoft die Genehmigung eines Administrators, beachten Sie Zustimmung durch einen Administrator. Danach zeigt Verbindungstest (F10) oAuth2 Token vorhanden.
Wählen Sie auf der Registerkarte Kalender den Sachbearbeiter.
Klicken Sie auf Kalender neu einlesen und wählen Sie bei Kalender den gewünschten Kalender. Der Standardkalender des Postfachs ist mit (Standardkalender) gekennzeichnet. Kalender mit (nur lesen) eignen sich nicht, weil OBS dort keine Termine anlegen kann.
Sichern Sie mit F2.

Auf der Registerkarte Synchronisation legen Sie mit Synchronisations-Interval fest, nach wie vielen Minuten OBS erneut abgleicht.

Umstellung von der Exchange-Terminsynchronisation

Liegt das Postfach eines bestehenden Kontos vom Typ Exchange Kalender-Sync in Exchange Online, stellen Sie es auf Microsoft Graph um. Die Zuordnung zwischen OBS-Terminen und Outlook-Terminen bleibt dabei erhalten, es entstehen keine doppelten Termine.

Öffnen Sie das Kalender-Konto und ändern Sie Cloud Typ auf Microsoft 365 Kalender-Sync (Graph).
Wählen Sie bei oAuth2 Connect einen OAuth2-Eintrag mit der Definition OAUTH2 Microsoft Graph(Outlook/Exchange).
Drücken Sie F10 und melden Sie sich mit demselben Konto an wie bisher.
Klicken Sie auf der Registerkarte Kalender auf Kalender neu einlesen, wählen Sie den Kalender und sichern Sie mit F2.

Beim ersten Abgleich nach der Umstellung erhält jeder Termin einmal den Protokolleintrag „durch Dienst obs_cloud geändert“. Danach ändert OBS nur noch Termine, die tatsächlich geändert wurden.

Konfiguration

Einstellung	Standard	Bedeutung
`Cloud.M365.Calendar.Zeitzone`	leer	Windows-Zeitzone für die Terminzeiten, z.B. `W. Europe Standard Time`. Leer bedeutet: Zeitzone des Rechners, auf dem der OBS-Cloud-Dienst läuft.
`Cloud.M365.Calendar.IdsMigriert`	N	Wird bei der Umstellung von der Exchange-Terminsynchronisation automatisch auf J gesetzt. Nicht von Hand ändern.

Übertragener Inhalt

Angabe	Übertragen	Hinweis
Titel	✓
Beschreibung	✓	als reiner Text
Ort	✓
Beginn und Ende	✓
Ganztägig	✓
Serientermine	✓	jedes Vorkommen als eigener Termin in OBS
Teilnehmer	–
Erinnerung	–
Kategorie	–

Besonderheiten

Wie OBS mit Änderungen, Löschungen und Terminarten umgeht und welcher Zeitraum abgeglichen wird, steht unter Grundlagen.

ACHTUNG: Richten Sie pro Sachbearbeiter nur ein aktives Kalender-Konto ein, wenn die Kalender außerhalb von OBS untereinander abgeglichen werden (z.B. Google, iCloud und Microsoft 365 über eine Sync-App oder Kontenmigration). Sonst übernimmt jedes Konto die Kopien der anderen als neue Termine, und bei jedem Abgleich entstehen doppelte Termine. OBS weist beim Speichern eines zweiten aktiven Kalender-Kontos darauf hin.

Meldungen im Protokoll des OBS-Cloud-Dienstes:

Meldung	Ursache
`MailboxNotEnabledForRESTAPI`	Das Postfach liegt nicht in Exchange Online, z.B. auf einem eigenen Exchange-Server, oder es fehlt die Exchange-Online-Lizenz. Für einen eigenen Exchange-Server verwenden Sie die Exchange-Terminsynchronisation.
`HTTP 401`	Der OAuth2-Eintrag hat die Definition OAUTH2 Microsoft (IMAP/POP/SMTP/EWS). Stellen Sie ihn auf OAUTH2 Microsoft Graph(Outlook/Exchange) um und melden Sie sich am Kalender-Konto mit F10 neu an.
„Nur … von … Termin-Ids uebersetzbar … Migration abgebrochen“	Bei der Umstellung wurde ein anderes Konto angemeldet als beim bisherigen Exchange-Konto. Melden Sie sich mit F10 mit dem richtigen Konto an.

Siehe auch