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

Exchange Kontakte

OBS überträgt die Ansprechpartner Ihrer Personen als Kontakte nach Microsoft Exchange, in eine Richtung von OBS nach Exchange. So stehen sie in Outlook und auf dem Smartphone zur Verfügung.

HINWEIS: Es handelt sich um ein kostenpflichtiges Modul. Die Schnittstelle muss über den OBS-Support aktiviert werden.

ACHTUNG: Die Personensynchronisation nutzt die Microsoft-Schnittstelle EWS. Microsoft stellt EWS in Exchange Online (Microsoft 365) 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. 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 Typ	Exchange Kontakt-Sync
Richtung	nur OBS nach Exchange
Übertragungsweg	OBS-Cloud-Dienst über Exchange Web Services (EWS)
Anmeldung	Login und Passwort, alternativ OAuth2
Übersicht	Cloud-Schnittstellen

Voraussetzungen

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

Einrichtung

Öffnen Sie Stammdaten → Z Weitere Stammdaten → Cloud Connect und legen Sie mit Einfg einen neuen Eintrag an.
Wählen Sie bei Cloud Typ Exchange Kontakt-Sync und vergeben Sie einen Titel, z.B. Kontakt-Sync öffentlicher Ordner.
Tragen Sie bei Hostname die EWS-Adresse ein und bei Login und Passwort die Zugangsdaten, z.B. DOMAIN\anna_b. Für eine Anmeldung mit OAuth2 wählen Sie stattdessen bei oAuth2 Connect einen OAuth2-Eintrag.
Legen Sie in der Konfiguration fest, in welchen Ordner OBS die Kontakte schreibt (siehe unten).
Setzen Sie das Häkchen Aktiv und sichern Sie mit F2.

Konfiguration

Die Einstellungen erreichen Sie mit F8 im Eintrag.

Einstellung	Standard	Bedeutung
`Cloud.Exchange.Contact.SaveInPublicFolder`	N	J: Kontakte im öffentlichen Kontakteordner speichern. N: im Kontakteordner des angemeldeten Benutzers.
`Cloud.Exchange.Contact.SubFolder`	leer	Unterordner, in dem die Kontakte gespeichert werden. Leer = oberste Ebene.
`Cloud.Exchange.Contact.SplitLieferPerson`	N	J: Kunden und Lieferanten in getrennten Unterordnern ablegen. Ansprechpartner von Personen, deren Nummer mit 1 beginnt, kommen in den Kunden-Ordner, alle anderen in den Lieferanten-Ordner.
`Exchange_Contact_Folder_Kunden`	OBS Kunden	Name des Unterordners für Kunden.
`Exchange_Contact_Folder_Lief`	OBS Lieferanten	Name des Unterordners für Lieferanten.
`Exchange_Contact_Folder_Mitarb`	OBS Mitarbeiter	Name des Unterordners für Mitarbeiter.
`Cloud.Exchange.Contact.MitarbEigen`	leer	Nummer der Eigenschaft, mit der Sie Ihre eigenen Mitarbeiter kennzeichnen. Ansprechpartner mit dieser Eigenschaft, an der Person oder am Ansprechpartner, legt OBS im Mitarbeiter-Ordner ab.
`Cloud.Exchange.Contact.DeleteSync`	N	J: Kontakte, die OBS nicht mehr überträgt, in Exchange löschen (siehe Besonderheiten). N: Sie bleiben in Exchange stehen und werden nicht mehr aktualisiert.

Übertragener Inhalt

OBS-Feld	Exchange-Feld
Vorname	Vorname
Name	Nachname
Firma	Firma
Geburtsdatum	Geburtstag
Abteilung	Abteilung
Position	Position
Bemerkung	Notizen
Adresse	Adresse geschäftlich
Privat-Adresse	Adresse privat
Telefon	Telefon geschäftlich
Telefon Privat	Telefon privat
Telefon Privat Mobil	Telefon privat 2
Telefon Mobil	Mobiltelefon
Fax	Fax geschäftlich
Email	E-Mail
Email Privat	E-Mail 2

Besonderheiten

Übertragen werden alle Ansprechpartner aktiver Personen. Ausgenommen sind inaktive Personen und Ansprechpartner sowie Personen und Ansprechpartner mit der Eigenschaft 9026 Keine Synchronisation in die Cloud, siehe Eigenschaften.
Wird ein Ansprechpartner gelöscht, inaktiv gesetzt oder ausgenommen, löscht OBS den Kontakt in Exchange nur, wenn Cloud.Exchange.Contact.DeleteSync auf J steht.
Änderungen in OBS überträgt OBS beim nächsten Abgleich, auch geleerte Felder. Änderungen an den Kontakten in Exchange oder Outlook übernimmt OBS nicht.
Ein Eintrag schreibt in den öffentlichen Kontakteordner oder in den Kontakteordner des angemeldeten Benutzers. Für die Kontakteordner weiterer Benutzer legen Sie je Benutzer einen eigenen Eintrag an.
Mit Exchange 2010 werden einige Daten nicht korrekt angezeigt. Verwenden Sie eine neuere Exchange-Version.

Siehe auch

@@ Zeile 1: / Zeile 1: @@
 {{Vorlage:CloudConnect}}
+{{Seitentyp|Schnittstelle}}
+= Exchange Kontakte =
+OBS überträgt die Ansprechpartner Ihrer Personen als Kontakte nach Microsoft Exchange, in eine Richtung von OBS nach Exchange. So stehen sie in Outlook und auf dem Smartphone zur Verfügung.
-=Personensynchronisation mit Exchange=
 {{Hinweis|Es handelt sich um ein kostenpflichtiges Modul. Die Schnittstelle muss über den OBS-Support aktiviert werden.}}
-[[Datei:Einrichtung_Beispiel.png]]
-Über die Cloud-Schnittstelle ist es möglich den Personenstamm aus OBS mit einem Microsoft Exchange-Server abgzugleichen.
-Legen Sie dazu unter 'Stammdaten - Weitere Stammdaten - Cloud Connect' einen neuen Datensatz an.
+{{Achtung|Die Personensynchronisation nutzt die Microsoft-Schnittstelle EWS. Microsoft stellt EWS in Exchange Online (Microsoft 365) 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. 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 Kontakt-Sync" ein.
-Geben Sie dem Datensatz einen aussagekräftigen Titel, beispielsweise "Kontakt-Sync - Publicfolder".
-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".
-Unter Login und Passwort tragen Sie die Zugangsdaten für den Exchange-benutzer ein 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"
-Nun können Sie den Haken bei 'Aktiv' setzen. Wenn Sie möchten, können Sie auch auf dem zweiten Reiter weitere Einstellungen vornehmen.
-Nachdem Sie den Datensatz mit F2 gespeichert haben, beginnt Zeitnah, spätestens nach der auf dem zweiten Reiter eingestellten Zeit, die Synchronisation der entsprechenden Termindaten.
-==Besonderheiten==
+{{Steckbrief
-Sie können Personen entweder in den Öffentlichen Kontakteordner von Exchange oder den privaten Kontakteordner des eingetragenen Benutzers sychronisieren.
+|Cloud Typ|''Exchange Kontakt-Sync''
-Das sychronisieren mit anderen privaten Kontakteordnern von anderen Benutzern ist dabei nicht möglich. Wenn Sie den Personenstamm auch mit diesen Ordnern synchronisieren möchten, müssen Sie mehrere Cloud-Einträge anlgen.
+|Richtung|nur OBS nach Exchange
+|Übertragungsweg|OBS-Cloud-Dienst über Exchange Web Services (EWS)
+|Anmeldung|Login und Passwort, alternativ OAuth2
+|Übersicht|[[OBS/CloudConnect/Übersicht|Cloud-Schnittstellen]]
+}}
-{{Hinweis|Die Synchronisation von Personen geht nur in eine Richtung - OBS -> Exchange. Das heißt, dass Änderungen, die am Exchange Server / Outlook an Personen vorgenommen werden nicht mit OBS synchronisiert werden!}}
+== Voraussetzungen ==
-{{Achtung|Exchange 2010 hat interne Fehler, die dazu führen dass einige Daten nicht korrekt angezeigt werden können. Daher empfehlen wir ausdrücklich die Verwendung von einer Exchange Version nach Exchange 2010!}}
+* Die EWS-Adresse Ihres Exchange-Servers, z.B. <code><nowiki>https://<Server>/ews/Exchange.asmx</nowiki></code>. Ihre IT kennt sie.
+* Die Zugangsdaten eines Exchange-Benutzers, dieselben wie für Outlook.
+* Der OBS-Cloud-Dienst ist im [[OBS/Systemadministration/OBS_Service_Manager|OBS Service Manager]] aktiv.
-==Konfiguration==
+== Einrichtung ==
-Unter {{F8}} Konfig. können Sie noch weitere Einstellungen für den Datensatz vornehmen.
+# Öffnen Sie '''Stammdaten → Z Weitere Stammdaten → Cloud Connect''' und legen Sie mit {{Einfg}} einen neuen Eintrag an.
+# Wählen Sie bei '''Cloud Typ''' ''Exchange Kontakt-Sync'' und vergeben Sie einen '''Titel''', z.B. ''Kontakt-Sync öffentlicher Ordner''.
+# Tragen Sie bei '''Hostname''' die EWS-Adresse ein und bei '''Login''' und '''Passwort''' die Zugangsdaten, z.B. ''DOMAIN\anna_b''. Für eine Anmeldung mit OAuth2 wählen Sie stattdessen bei '''oAuth2 Connect''' einen [[OBS/CloudConnect/OAuth2|OAuth2-Eintrag]].
+# Legen Sie in der Konfiguration fest, in welchen Ordner OBS die Kontakte schreibt (siehe unten).
+# Setzen Sie das Häkchen '''Aktiv''' und sichern Sie mit {{F2}}.
+== Konfiguration ==
+Die Einstellungen erreichen Sie mit {{F8}} im Eintrag.
 {| class="wikitable"
+! Einstellung !! Standard !! Bedeutung
+|-
+| <code>Cloud.Exchange.Contact.SaveInPublicFolder</code> || ''N'' || ''J'': Kontakte im öffentlichen Kontakteordner speichern. ''N'': im Kontakteordner des angemeldeten Benutzers.
 |-
-!Konfiguration !! Beschreibung
+| <code>Cloud.Exchange.Contact.SubFolder</code> || leer || Unterordner, in dem die Kontakte gespeichert werden. Leer = oberste Ebene.
 |-
-| Cloud.Exchange.Contact.DeleteSync || Gelöschte Daten in OBS mit der Cloud synchronisieren
+| <code>Cloud.Exchange.Contact.SplitLieferPerson</code> || ''N'' || ''J'': Kunden und Lieferanten in getrennten Unterordnern ablegen. Ansprechpartner von Personen, deren Nummer mit 1 beginnt, kommen in den Kunden-Ordner, alle anderen in den Lieferanten-Ordner.
 |-
-| Cloud.Exchange.Contact.MitarbEigen || Eigenschaft, mit der eingene Mitarbeiter gekennzeichnet werden. Diese werden in einem Unterordner abgelegt.
+| <code>Exchange_Contact_Folder_Kunden</code> || ''OBS Kunden'' || Name des Unterordners für Kunden.
 |-
-| Cloud.Exchange.Contact.SaveInPublicFolder || Speichern der Personen im öffentlichen Kontakteordner
+| <code>Exchange_Contact_Folder_Lief</code> || ''OBS Lieferanten'' || Name des Unterordners für Lieferanten.
 |-
-| Cloud.Exchange.Contact.SplitLieferPerson || Personen und Lieferatnen werden in seperaten Unterordnern abgelegt
+| <code>Exchange_Contact_Folder_Mitarb</code> || ''OBS Mitarbeiter'' || Name des Unterordners für Mitarbeiter.
 |-
-| Cloud.Exchange.Contact.SubFolder || Unterordner zum Speichern der Daten (Leer = Root)
+| <code>Cloud.Exchange.Contact.MitarbEigen</code> || leer || Nummer der Eigenschaft, mit der Sie Ihre eigenen Mitarbeiter kennzeichnen. Ansprechpartner mit dieser Eigenschaft, an der Person oder am Ansprechpartner, legt OBS im Mitarbeiter-Ordner ab.
 |-
+| <code>Cloud.Exchange.Contact.DeleteSync</code> || ''N'' || ''J'': Kontakte, die OBS nicht mehr überträgt, in Exchange löschen (siehe Besonderheiten). ''N'': Sie bleiben in Exchange stehen und werden nicht mehr aktualisiert.
 |}
-==Feldzuweisungen==
+== Übertragener Inhalt ==
-Aktuell werden folgende Felder übertragen:
 {| class="wikitable"
-|-
 ! OBS-Feld !! Exchange-Feld
 |-
-| Vorname|| GivenName
+| Vorname || Vorname
-|-
-| Name || Surname
 |-
-| Firma || CompanyName
+| Name || Nachname
 |-
-| Geburtsdatum || Birthday
+| Firma || Firma
 |-
-| Abteilung || Department
+| Geburtsdatum || Geburtstag
 |-
-| Position || JobTitle
+| Abteilung || Abteilung
 |-
-| Bemerkung || Body (Notiz)
+| Position || Position
 |-
-| Adresse || PhysicalAddresses.Business
+| Bemerkung || Notizen
 |-
-| Privat-Adresse || PhysicalAddresses.Home
+| Adresse || Adresse geschäftlich
 |-
-| Telefon || BusinessPhone
+| Privat-Adresse || Adresse privat
 |-
-| Telefon Privat || HomePhone
+| Telefon || Telefon geschäftlich
 |-
-| Telefon Privat Mobil || HomePhone2
+| Telefon Privat || Telefon privat
 |-
-| Telefon Mobil || MobilePhone
+| Telefon Privat Mobil || Telefon privat 2
 |-
-| Fax || BusinessFax
+| Telefon Mobil || Mobiltelefon
 |-
-| Email || EmailAddress1
+| Fax || Fax geschäftlich
 |-
-| Email Privat || EmailAddress2
+| Email || E-Mail
 |-
+| Email Privat || E-Mail 2
 |}
+== Besonderheiten ==
+* Übertragen werden alle Ansprechpartner aktiver Personen. Ausgenommen sind inaktive Personen und Ansprechpartner sowie Personen und Ansprechpartner mit der Eigenschaft 9026 ''Keine Synchronisation in die Cloud'', siehe [[OBS/Eigenschaften|Eigenschaften]].
+* Wird ein Ansprechpartner gelöscht, inaktiv gesetzt oder ausgenommen, löscht OBS den Kontakt in Exchange nur, wenn <code>Cloud.Exchange.Contact.DeleteSync</code> auf ''J'' steht.
+* Änderungen in OBS überträgt OBS beim nächsten Abgleich, auch geleerte Felder. Änderungen an den Kontakten in Exchange oder Outlook übernimmt OBS nicht.
+* Ein Eintrag schreibt in den öffentlichen Kontakteordner oder in den Kontakteordner des angemeldeten Benutzers. Für die Kontakteordner weiterer Benutzer legen Sie je Benutzer einen eigenen Eintrag an.
+* Mit Exchange 2010 werden einige Daten nicht korrekt angezeigt. Verwenden Sie eine neuere Exchange-Version.
+== Siehe auch ==
+* [[OBS/CloudConnect/OAuth2|OAuth2-Authentifizierung]]
+* [[OBS/CloudConnect/Übersicht|Cloud-Schnittstellen]]