Zum Inhalt springen

OBS/CloudConnect/Microsoft 365 Kalender: Unterschied zwischen den Versionen

Aus OBS Wiki
MINERVA-Thiel (Diskussion | Beiträge)
K MINERVA-Thiel verschob die Seite OBS/CloudConnect/Microsoft 365-Terminsync nach OBS/CloudConnect/Microsoft 365 Kalender: Seitentitel als Klarname (Styleguide), Weiterleitung bleibt
MINERVA-Thiel (Diskussion | Beiträge)
Feldnamen des OAuth2-Eintrags korrigiert: App ID und App Secret ID statt Login und Passwort [Volltext ersetzt]
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 1: Zeile 1:
{{Vorlage:CloudConnect}}
{{Vorlage:CloudConnect}}
{{Seitentyp|Schnittstelle}}
{{Seitentyp|Schnittstelle}}
= Microsoft 365-Terminsync =
= 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 [[OBS/CloudConnect/Exchange-Terminsync|Exchange-Terminsynchronisation]].
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 [[OBS/CloudConnect/Exchange Kalender|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/Systemadministration/OBS_Service_Manager|OBS Service Manager]] aktiv sein.}}
{{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/Systemadministration/OBS_Service_Manager|OBS Service Manager]] aktiv sein.}}
Zeile 12: Zeile 12:
|Übertragungsweg|OBS-Cloud-Dienst über Microsoft Graph
|Übertragungsweg|OBS-Cloud-Dienst über Microsoft Graph
|Anmeldung|OAuth2 mit der Definition ''OAUTH2 Microsoft Graph(Outlook/Exchange)''
|Anmeldung|OAuth2 mit der Definition ''OAUTH2 Microsoft Graph(Outlook/Exchange)''
|Übersicht|[[OBS/CloudConnect/Uebersicht|Cloud-Schnittstellen]]
|Übersicht|[[OBS/CloudConnect/Übersicht|Cloud-Schnittstellen]]
}}
}}


== Voraussetzungen ==
== 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.
* 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 [[OBS/CloudConnect/oAuth2|oAuth2-Authentifizierung]].
* Im Microsoft-Entra-Portal ist eine App-Registrierung mit Anwendungs-ID und geheimem Clientschlüssel eingerichtet, siehe [[OBS/CloudConnect/OAuth2|oAuth2-Authentifizierung]].


== Einrichtung ==
== Einrichtung ==
Zeile 24: Zeile 24:
# Öffnen Sie '''Stammdaten → Z Weitere Stammdaten → Cloud Connect''' und legen Sie mit {{Einfg}} einen neuen Eintrag an.
# Ö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)''.
# Wählen Sie bei '''Cloud Typ''' die Definition ''OAUTH2 Microsoft Graph(Outlook/Exchange)''.
# Tragen Sie bei '''Login''' die Anwendungs-ID und bei '''Passwort''' den geheimen Clientschlüssel ein.
# Tragen Sie bei '''App ID''' die Anwendungs-ID und bei '''App Secret ID''' den Wert des geheimen Clientschlüssels ein.
# Sichern Sie mit {{F2}}.
# Sichern Sie mit {{F2}}.


Zeile 81: Zeile 81:


== Besonderheiten ==
== Besonderheiten ==
Abgeglichen werden die Termine von 5 Tagen in der Vergangenheit bis 12 Monate in der Zukunft.
Wie OBS mit Änderungen, Löschungen und Terminarten umgeht und welcher Zeitraum abgeglichen wird, steht unter [[OBS/CloudConnect/Übersicht#Grundlagen|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.}}
{{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.}}
Zeile 89: Zeile 89:
! Meldung !! Ursache
! Meldung !! Ursache
|-
|-
| <code>MailboxNotEnabledForRESTAPI</code> || 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 [[OBS/CloudConnect/Exchange-Terminsync|Exchange-Terminsynchronisation]].
| <code>MailboxNotEnabledForRESTAPI</code> || 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 [[OBS/CloudConnect/Exchange Kalender|Exchange-Terminsynchronisation]].
|-
|-
| <code>HTTP 401</code> || 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.
| <code>HTTP 401</code> || 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.
Zeile 97: Zeile 97:


== Siehe auch ==
== Siehe auch ==
* [[OBS/CloudConnect/Uebersicht|Cloud-Schnittstellen]]
* [[OBS/CloudConnect/Übersicht|Cloud-Schnittstellen]]
* [[OBS/CloudConnect/oAuth2|oAuth2-Authentifizierung]]
* [[OBS/CloudConnect/OAuth2|oAuth2-Authentifizierung]]
* [[OBS/CloudConnect/Exchange-Terminsync|Exchange-Terminsynchronisation]]
* [[OBS/CloudConnect/Exchange Kalender|Exchange-Terminsynchronisation]]

Aktuelle Version vom 2. Oktober 2026, 10:12 Uhr

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 TypMicrosoft 365 Kalender-Sync (Graph)
RichtungOBS und Microsoft 365, beide Richtungen
ÜbertragungswegOBS-Cloud-Dienst über Microsoft Graph
AnmeldungOAuth2 mit der Definition OAUTH2 Microsoft Graph(Outlook/Exchange)
ÜbersichtCloud-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.

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

Kalender-Konto

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

  1. Legen Sie in Cloud Connect mit Einfg einen neuen Eintrag an.
  2. Wählen Sie bei Cloud Typ Microsoft 365 Kalender-Sync (Graph) und vergeben Sie einen Titel, z.B. Termine Anna B..
  3. Wählen Sie bei oAuth2 Connect den OAuth2-Eintrag und setzen Sie das Häkchen Aktiv.
  4. 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. Danach zeigt Verbindungstest (F10) oAuth2 Token vorhanden.
  5. Wählen Sie auf der Registerkarte Kalender den Sachbearbeiter.
  6. 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.
  7. 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.

  1. Öffnen Sie das Kalender-Konto und ändern Sie Cloud Typ auf Microsoft 365 Kalender-Sync (Graph).
  2. Wählen Sie bei oAuth2 Connect einen OAuth2-Eintrag mit der Definition OAUTH2 Microsoft Graph(Outlook/Exchange).
  3. Drücken Sie F10 und melden Sie sich mit demselben Konto an wie bisher.
  4. 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