Zum Inhalt springen

OBS/CloudConnect/Exchange Kalender: Unterschied zwischen den Versionen

Aus OBS Wiki
Thiel (Diskussion | Beiträge)
MINERVA-Thiel (Diskussion | Beiträge)
Seite neu geschrieben: EWS-Abschaltung, Anmeldung, Kalenderauswahl, Meldungen [Volltext ersetzt]
 
(6 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Vorlage:CloudConnect}}
{{Vorlage:CloudConnect}}
{{Hinweis|Es handelt sich um ein kostenpflichtiges Modul. Die Schnittstelle muss über den OBS-Support aktiviert werden.}}
{{Seitentyp|Schnittstelle}}
[[Datei:Cloud Connect Exchange Beispiel.png]]
= Exchange Kalender =


==Terminsynchronisation mit Exchange==
OBS gleicht die Termine eines Sachbearbeiters mit einem Kalender auf einem eigenen Microsoft Exchange-Server ab, in beide Richtungen.


Über eine neue Schnittstelle wird es bald möglich sein, Termindaten auch mit einem Microsoft Exchange-Server abgzugleichen.
{{Hinweis|Es handelt sich um ein kostenpflichtiges Modul. Das Modul '''Cloud: Exchange Termine''' muss über den OBS-Support aktiviert werden.}}


Legen Sie dazu für jeden Sachbearbeiter, dessen Termine synchronisiert werden sollen, unter 'Stammdaten - Weitere Stammdaten - Cloud Connect' einen neuen Datensatz an.
{{Achtung|Für Postfächer in Exchange Online (Microsoft 365) verwenden Sie die [[OBS/CloudConnect/Microsoft 365 Kalender|Microsoft 365-Terminsynchronisation]]. Die Exchange-Terminsynchronisation nutzt die Microsoft-Schnittstelle EWS, und Microsoft stellt EWS in Exchange Online ein: Seit dem 01.10.2026 ist EWS dort standardmäßig abgeschaltet und kann vom Administrator des Microsoft-365-Mandanten nur noch übergangsweise wieder freigeschaltet werden. Schon vorher hat Microsoft EWS in laufenden Mandanten zeitweise abgeschaltet. Ab dem 01.04.2027 ist EWS in Exchange Online endgültig nicht mehr verfügbar. Eigene Exchange-Server im Haus sind nicht betroffen.}}


Öffnen Sie den Datensatz und stellen Sie den Cloud-Typ "Exchange Kalender-Sync" ein.
{{Steckbrief
|Cloud Typ|''Exchange Kalender-Sync''
|Richtung|OBS und Exchange, beide Richtungen
|Übertragungsweg|OBS-Cloud-Dienst über Exchange Web Services (EWS)
|Anmeldung|Login und Passwort, alternativ OAuth2
|Übersicht|[[OBS/CloudConnect/Übersicht|Cloud-Schnittstellen]]
}}


Geben Sie dem Datensatz einen aussagekräftigen Titel, beispielsweise "Terminsync. Exchange für Anna B.".
== Voraussetzungen ==
* Die EWS-Adresse Ihres Exchange-Servers, z.B. <code><nowiki>https://<Server>/ews/Exchange.asmx</nowiki></code>. Ihre IT kennt sie.
* Die Zugangsdaten des Postfachs, dieselben wie für Outlook.
* Der OBS-Cloud-Dienst ist im [[OBS/Systemadministration/OBS_Service_Manager|OBS Service Manager]] aktiv.


Erfragen Sie von Ihrer IT die .asmx-Adresse, unter der Ihr Exchange-Server im Netzwerk erreichbar ist, und tragen Sie diese unter Host ein, beispielsweise "https://server.domain/ews/Exchange.asmx".
== Einrichtung ==
Legen Sie für jeden Sachbearbeiter, dessen Termine abgeglichen werden sollen, ein eigenes Kalender-Konto an.
# Öffnen Sie '''Stammdaten → Z Weitere Stammdaten → Cloud Connect''' und legen Sie mit {{Einfg}} einen neuen Eintrag an.
# Wählen Sie bei '''Cloud Typ''' ''Exchange Kalender-Sync'' und vergeben Sie einen '''Titel''', z.B. ''Termine Anna B.''. Setzen Sie das Häkchen '''Aktiv'''.
# Tragen Sie bei '''Hostname''' die EWS-Adresse ein.
# Tragen Sie bei '''Login''' und '''Passwort''' die Zugangsdaten ein, z.B. ''DOMAIN\anna_b''. Lassen Sie '''oAuth2 Connect''' leer.
# Sichern Sie mit {{F2}}.
# 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.
# Sichern Sie mit {{F2}}.


Unter Login und Passwort tragen Sie die Zugangsdaten für den Sachbearbeiter für Ihren Exchange-Server ein. Dies sind die selben Zugangsdaten, die Sie für einen Login in anderen Programmen, wie MS Outlook, benötigen. Beispiel: "server.domain\anna_b"
=== Anmeldung mit OAuth2 ===
Statt mit Login und Passwort können Sie sich mit OAuth2 anmelden. Wählen Sie dazu bei '''oAuth2 Connect''' einen [[OBS/CloudConnect/OAuth2|OAuth2-Eintrag]] mit der Definition ''OAUTH2 Microsoft (IMAP/POP/SMTP/EWS)''. Ist '''oAuth2 Connect''' gefüllt, verwendet OBS ausschließlich die OAuth2-Anmeldung. Ein eigener Exchange-Server nimmt eine OAuth2-Anmeldung nur an, wenn er dafür eingerichtet ist.


Tragen Sie zuletzt als Sachbearbeiter im zweiten Reiter der Maske den OBS-Sachbearbeiter ein, für den der Kalender synchronisiert werden soll.
== Übertragener Inhalt ==
{| class="wikitable"
! Angabe !! Übertragen !! Hinweis
|-
| Titel || ✓ ||
|-
| Beschreibung || ✓ || als reiner Text
|-
| Ort || ✓ ||
|-
| Beginn und Ende || ✓ ||
|-
| Ganztägig || ✓ ||
|-
| Serientermine || ✓ || jedes Vorkommen als eigener Termin in OBS
|-
| Teilnehmer || – || Termine aus OBS legt Exchange ohne Einladungen an
|-
| Erinnerung || – ||
|}


Wenn Sie möchten, können Sie auch auf dem zweiten Reiter weitere Einstellungen für den Kalender vornehmen.
== Besonderheiten ==
* Wie OBS mit Änderungen, Löschungen und Terminarten umgeht und welcher Zeitraum abgeglichen wird, steht unter [[OBS/CloudConnect/Übersicht#Grundlagen|Grundlagen]].
* Wählen Sie den Kalender bewusst aus. Legen Sie in Exchange am besten einen eigenen Kalender für die Termine aus OBS an.


Nachdem Sie den Datensatz mit F2 gespeichert haben, beginnt Zeitnah, spätestens nach der auf dem dritten Reiter eingestellten Zeit, die Synchronisation der entsprechenden Termindaten.
Meldungen im Protokoll des OBS-Cloud-Dienstes:
{| class="wikitable"
! Meldung !! Ursache
|-
| <code>Unauthorized (401)</code> || Der Exchange-Server nimmt die Anmeldung nicht an. Prüfen Sie Login und Passwort. Bei einem eigenen Exchange-Server ohne OAuth2-Einrichtung leeren Sie '''oAuth2 Connect'''.
|-
| <code>ErrorNonExistentMailbox</code> || Als Hostname ist <code>https://outlook.office.com/ews/Exchange.asmx</code> eingetragen, das Postfach liegt aber auf einem eigenen Exchange-Server. Tragen Sie die Adresse des eigenen Servers ein.
|}


Achten Sie darauf, dass das Häkchen bei "aktiv" im ersten Reiter gesetzt ist.
== Siehe auch ==
 
* [[OBS/CloudConnect/Microsoft 365 Kalender|Microsoft 365-Terminsynchronisation]]
=oAuth2=
* [[OBS/CloudConnect/OAuth2|OAuth2-Authentifizierung]]
Für die Verbindung mit oAuth2 benötigen Sie einen eingerichteten [[OBS/CloudConnect/oAuth2|CloudConnect]] für oAuth2. Diesen können Sie im Feld oAuth2 Connect eintragen.
* [[OBS/CloudConnect/Übersicht|Cloud-Schnittstellen]]

Aktuelle Version vom 2. Oktober 2026, 08:35 Uhr

Exchange Kalender

OBS gleicht die Termine eines Sachbearbeiters mit einem Kalender auf einem eigenen Microsoft Exchange-Server ab, in beide Richtungen.

HINWEIS: Es handelt sich um ein kostenpflichtiges Modul. Das Modul Cloud: Exchange Termine muss über den OBS-Support aktiviert werden.
ACHTUNG: Für Postfächer in Exchange Online (Microsoft 365) verwenden Sie die Microsoft 365-Terminsynchronisation. Die Exchange-Terminsynchronisation nutzt die Microsoft-Schnittstelle EWS, und Microsoft stellt EWS in Exchange Online ein: Seit dem 01.10.2026 ist EWS dort standardmäßig abgeschaltet und kann vom Administrator des Microsoft-365-Mandanten nur noch übergangsweise wieder freigeschaltet werden. Schon vorher hat Microsoft EWS in laufenden Mandanten zeitweise abgeschaltet. Ab dem 01.04.2027 ist EWS in Exchange Online endgültig nicht mehr verfügbar. Eigene Exchange-Server im Haus sind nicht betroffen.
Steckbrief
Cloud TypExchange Kalender-Sync
RichtungOBS und Exchange, beide Richtungen
ÜbertragungswegOBS-Cloud-Dienst über Exchange Web Services (EWS)
AnmeldungLogin und Passwort, alternativ OAuth2
ÜbersichtCloud-Schnittstellen

Voraussetzungen

  • Die EWS-Adresse Ihres Exchange-Servers, z.B. https://<Server>/ews/Exchange.asmx. Ihre IT kennt sie.
  • Die Zugangsdaten des Postfachs, dieselben wie für Outlook.
  • Der OBS-Cloud-Dienst ist im OBS Service Manager aktiv.

Einrichtung

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

  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 Exchange Kalender-Sync und vergeben Sie einen Titel, z.B. Termine Anna B.. Setzen Sie das Häkchen Aktiv.
  3. Tragen Sie bei Hostname die EWS-Adresse ein.
  4. Tragen Sie bei Login und Passwort die Zugangsdaten ein, z.B. DOMAIN\anna_b. Lassen Sie oAuth2 Connect leer.
  5. Sichern Sie mit F2.
  6. Wählen Sie auf der Registerkarte Kalender den Sachbearbeiter.
  7. Klicken Sie auf Kalender neu einlesen und wählen Sie bei Kalender den gewünschten Kalender.
  8. Sichern Sie mit F2.

Anmeldung mit OAuth2

Statt mit Login und Passwort können Sie sich mit OAuth2 anmelden. Wählen Sie dazu bei oAuth2 Connect einen OAuth2-Eintrag mit der Definition OAUTH2 Microsoft (IMAP/POP/SMTP/EWS). Ist oAuth2 Connect gefüllt, verwendet OBS ausschließlich die OAuth2-Anmeldung. Ein eigener Exchange-Server nimmt eine OAuth2-Anmeldung nur an, wenn er dafür eingerichtet ist.

Ü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 – Termine aus OBS legt Exchange ohne Einladungen an
Erinnerung –

Besonderheiten

  • Wie OBS mit Änderungen, Löschungen und Terminarten umgeht und welcher Zeitraum abgeglichen wird, steht unter Grundlagen.
  • Wählen Sie den Kalender bewusst aus. Legen Sie in Exchange am besten einen eigenen Kalender für die Termine aus OBS an.

Meldungen im Protokoll des OBS-Cloud-Dienstes:

Meldung Ursache
Unauthorized (401) Der Exchange-Server nimmt die Anmeldung nicht an. Prüfen Sie Login und Passwort. Bei einem eigenen Exchange-Server ohne OAuth2-Einrichtung leeren Sie oAuth2 Connect.
ErrorNonExistentMailbox Als Hostname ist https://outlook.office.com/ews/Exchange.asmx eingetragen, das Postfach liegt aber auf einem eigenen Exchange-Server. Tragen Sie die Adresse des eigenen Servers ein.

Siehe auch