GraphAPI
Allgemein
Darstellung von Terminen aus Exchange in eserp
Um die Probleme zu reduzieren, die durch die unterschiedlichen Bearbeitungsmöglichkeiten von Terminen im eserp und Exchange entstehen können, erhalten Termine einen Marker der angibt, in welchem System sie angelegt wurden. Termine, die aus Exchange stammen, können nicht mehr über den Termineingabedialog im eserp editiert werden.
Ein entsprechender Hinweis wird im geöffneten Termin im eserp angezeigt.
Stattdessen wird der Termin beim Schalten in den Bearbeiten-Modus in der Exchange-Weboberfläche geöffnet und kann dort modifiziert werden.
Damit der Termin in der Weboberfläche geöffnet werden kann, muss der Termin im Exchange Kalender des angemeldeten Benutzers sein. Es können also nur Termine geöffnet werden, denen der aktuelle Benutzer entweder als Besitzer oder Konferenzteilnehmer zugeordnet ist und für den Benutzer muss die Exchangesynchronisierung aktiv sein.
Die Zuordnung von Vorgängen zu einem Termin ist aber optional möglich sein.
Die Termine werden als readonly synchronisiert, damit sie z.B. bei Prüfung auf Terminkonflikte berücksichtigt werden und z.B. in Vorgängen angezeigt werden.
Übertragen von Terminen aus eserp nach Exchange
Die Termine der gemäß Exchange-Konfiguration zu synchronisierenden Mitarbeiter werden an Exchange übertragen.
Die Synchronisierung erfolgt analog zum Abgleich über EWS zeitgesteuert in dem in der Exchange-Konfiguration festgelegten Intervall.
Die sonstigen Einstellungen für die Terminsynchronisierung (Mapping Aktivitätsarten zu Outlook-Kategorien, Prioritäten und Übergabe Equipment) werden ebenfalls ausgewertet.
Servertyp Exchange GraphAPI
OAuth Anwendungs-ID (Client)
Tragen Sie hier die OAuth Anwendungs-ID des Clients für die Verbindung zum Exchange Server ein.
OAuth Verzeichnis-ID (Mandant)
In diesem Feld wird die OAuth Verzeichnis-ID für den Mandanten der Verbindung hinterlegt.
OAuth Clientschlüssel
Für die Verbindung zum Exchange-Server ist zusätzlich ein OAuth Clientschlüssel erforderlich.
Synchronisierungsbeginn
Das Datum ab dem die Synchronisierung beginnen soll.
Synchronisierungszeitraum in Monaten
Wie groß der Synchronisierungszeitraum insgesamt ist.
Synchronisierungszeitraum Vergangenheit in Tagen
Wie viele Tage in die Vergangenheit synchronisiert wird.
Aktivitätsarten synchronisieren
Mit dieser Option wird die Synchronisierung der Aktivitätsarten und Outlook-Kategorien aktiviert.
Wenn diese Option aktiviert ist, werden Exchange Termine und Aufgaben mit den im Bereich Aktivitätsarten beschriebenen Aktivitätsarten übernommen.
Verbindung prüfen / Auth-Token erfragen
Über die Schaltfläche Verbindung prüfen (Auth-Token erfragen) können Sie nach Eingabe der benötigten Zugangsdaten die Verbindung zum Exchangeserver überprüfen und ggf. ein Authentifizierungs-Token vom Exchangeserver anfordern.
Zusätzliche GraphAPI Berechtigungen
Für den Betrieb der esExchange Schnittstelle über die GraphAPI ist es notwendig, weitere Berechtigungen in der registrierten App in Ihrem Microsoft Entra Admin Center vorzunehmen. Die folgenden Berechtigungen werden benötigt:
- User.ReadAll
- Calendar.ReadWrite
- Mail.Send (Sofern Mailversand über GraphAPI durchgeführt werden soll)
- Mail.ReadWrite (Sofern Mailimport über GraphAPI duchgeführt werden soll)