Microsoft Exchange Online Spoke
Die Microsoft Exchange Online-Spoke erstellt und verwaltet Kalender und E-Mail in Microsoft Exchange Online. Um Benutzer und Gruppen zu erstellen, zu verwalten oder zu löschen, verwenden Sie die Microsoft Azure AD-Spoke.
Hinweis:
Die Anwender- und Gruppenverwaltung kann nur mit Microsoft Azure AD und nicht mit Microsoft Exchange Online-Spokeerfolgen.
Apps im Store anfordern
Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.
IntegrationHub-Abonnement
Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.
Spoke-Version
Microsoft Exchange Online-Spoke v3.7.1 ist die neueste Version.
Spoke-Abhängigkeiten
Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
- ServiceNow Flow Designer – Dynamische Eingaben (com.glide.hub.dynamic_inputs)
- Komplexes Objekt (com.glide.cobject)
- ServiceNow IntegrationHub Action Template – Data Stream (com.glide.hub.action_type.datastream)
- Remotetabellen (com.glide.script.vtable)
- Systemimport-Datenquelle (com.glide.system_import_data_source)
- iHub Spoke Util Pack (com.snc.ihub_spoke_util_pack)
Hinweis:
Einige dieser Plugins sind lizenzierbare Funktionen und erfordern eine entsprechende Lizenz, wenn sie außerhalb der Spoke-Implementierung verwendet werden. Informationen zu Lizenzen erhalten Sie von Ihrem Account Manager.
Unterstützte Version
Microsoft Graph REST API v1.0
Spoke-Modul
Microsoft Exchange Online-Spoke fügt Ihrer -Instanz die Anwendung Microsoft Exchange Online hinzu und enthält diese Module:
| Modul | Beschreibung |
|---|---|
| Ereignisse | Zeigt die Liste der Ereignisse in Microsoft Exchange Online an. |
| Abonnements | Zeigt die Liste der Abonnements in Microsoft Exchange Online an. |
| Webhook-Registrierung | Zeigt die Liste der Webhook-Registrierungen von Microsoft Exchange Online an. |
| Kalender | Zeigt eine Liste der Kalender in Microsoft Exchange Online an. |
| Kalenderereignis – Daten umwandeln | Zeigt die Liste der Datensätze aus der Datenquelle an. |
Spoke-Abläufe
Die Microsoft Exchange Online-Spoke bietet Beispiel-Flows im Status „Veröffentlicht“, um die Automatisierung der Verlängerung von Abonnements zu demonstrieren. Verfügbare Beispielabläufe umfassen Folgendes:
| Flow | Beschreibung |
|---|---|
| Abonnements verlängern | Ruft alle Abonnementdatensätze ab und verlängert die Abonnements, wenn eine Verlängerung basierend auf der Ablaufzeit erforderlich ist. Wenn der Status eines Abonnements als „Wird gelöscht“ markiert ist, wird der zugehörige Datensatz gelöscht und kann nicht verlängert werden. |
Spoke-Unterabläufe
Die -Spoke stellt Subflows im Status Veröffentlicht für die Integration mit dem -Service Microsoft Exchange Online bereit. Diese Subflows können als Teil anderer Subflows und Flows verwendet werden.
| Kategorie | Subflows | Beschreibung |
|---|---|---|
| Webhook-Verwaltung | Überprüfen Sie das Ereignisabonnement | Überprüft, ob ein Webhook-Abonnement mit der angegebenen Ereignisressource oder Benachrichtigungs-URL und dem Change-Typ vorhanden ist. |
| Abonnementdatensatz erstellen oder aktualisieren | Überprüft, ob der angegebene Abonnementdatensatz in Microsoft Exchange Online vorhanden ist, und aktualisiert den Abonnementdatensatz, falls vorhanden. Wenn der Abonnementdatensatz nicht vorhanden ist, wird ein neuer Abonnementdatensatz erstellt. | |
| Abonnements für Ressourcen erstellen oder aktualisieren | Sucht nach Abonnements für die angegebenen Ressourcen. Wenn das Abonnement für die angegebenen Ressourcen nicht vorhanden ist, werden neue Abonnements erstellt. Hinweis: Dieser Subflow ist nur verfügbar, wenn das Plugin Workplace-Kalender-Synchronisierung bereits installiert ist. |
|
| Abonnement löschen | Löscht das angegebene Abonnement, wenn das angegebene Abonnement nur mit der angegebenen Anwendung verknüpft ist. | |
| Entferntes Abonnement neu erstellen | Erstellt ein entferntes Webhook-Abonnement mit den Details aus dem zugehörigen Abonnementdatensatz neu. | |
| Subscription Lifecycle Management | Verwaltet den Lebenszyklus eines Webhook-Abonnements. | |
| Kalenderverwaltung | Kalendersynchronisierung | Synchronisiert den Kalender, indem Ereignisse aus der Tabelle mit transformierten Daten für Exchange Online-Kalenderereignisse abgerufen und die abgerufenen Ereignisse der Tabelle Microsoft Exchange Online Ereignisse hinzugefügt werden. Erstellt ein Abonnement, wenn für den angegebenen Kalender des Benutzers kein gültiges Abonnement vorhanden ist. |
| Ereignisdatensatz erstellen oder aktualisieren | Sucht nach dem bestimmten vorhandenen Ereignisdatensatz und aktualisiert ihn mit den angegebenen Eigenschaften. Wenn der angegebene Ereignisdatensatz nicht vorhanden ist, wird ein neuer Ereignisdatensatz erstellt. | |
| Löschen Sie das Kalenderplanungsereignis | Löscht das angegebene Ereignis in Microsoft Exchange Online und die zugehörigen Datensätze aus Ereignistabellen, zugehörigen Anhängen, zugehörigen Datensätzen von Ereignisteilnehmern und Ereignis-zu-Abonnement-M2M-Tabellen. | |
| Ereignisdatensatz löschen | Löscht den angegebenen Ereignisdatensatz aus Ereignistabellen und den zugehörigen Anhängen, zugehörigen Datensätzen von Ereignisteilnehmern und Ereignis-zu-Abonnement-M2M-Tabellen. | |
| Event Lifecycle Management | Ruft die Ereignisdetails ab und aktualisiert die Datensätze in den Tabellen „Ereignis“, „Teilnehmer“, „Ereignis für Abonnement“ entsprechend. | |
| Anhänge für Ereignisdatensatz suchen und aktualisieren | Ruft die Anhänge eines bestimmten Ereignisdatensatzes aus Microsoft Exchange Online ab und aktualisiert sie. | |
| Suchen und aktualisieren Sie die Kalenderplanungsänderung | Ruft die Ereignisdetails eines angegebenen Ereignisdatensatzes ab und aktualisiert sie. | |
| Ereignisse synchronisieren | Synchronisiert die Kalenderansicht basierend auf den Daten aus der Tabelle mit den transformierten Daten für Exchange Online-Kalenderereignisse. | |
| Kalenderplanungsereignis aktualisieren | Aktualisiert die Eigenschaften eines Ereignisobjekts in Microsoft Exchange Online und des zugehörigen Datensatzes in der Ereignistabelle. |
Hinweis:
- Verwenden Sie die Microsoft Exchange Online-Webhook-Registrierungstabelle, um eine Rückruf-URL zu generieren und den geheimen Wert (Clientstatus) für Webhook-Abonnements zu speichern.
- Stellen Sie sicher, dass das Webhook-Abonnement in der Microsoft Exchange Online-Abonnementtabelle mit dem Feld „Status“ auf „Aktiv“ festgelegt ist.
Spoke-Aktionen
Microsoft Exchange Online-Spoke bietet Aktionen zur Automatisierung von Kalender- und E-Mail-Aufgaben, wenn in der Instanz ServiceNow ein Incident erstellt wird.
| Kategorie | Aktion | Beschreibung |
|---|---|---|
| Kalenderverwaltung | Anhang in Kalenderereignis kopieren | Kopiert einen ServiceNow -Anhang in ein Exchange -Kalenderereignis. |
| Kalenderereignis erstellen | Erstellt ein Ereignis im Standardkalender des Anwenders und gibt die Zeitzone für die Start- und Endzeit des Ereignisses an. | |
| Wiederkehrende Kalenderereignisse erstellen | Erstellt ein wiederkehrendes Ereignis im Standardkalender des Anwenders und gibt die Zeitzone für die Start- und Endzeit des Ereignisses an. | |
| Anhang löschen | Löscht den angegebenen Anhang im angegebenen Ereignis. | |
| Kalenderereignis löschen | Löscht ein Kalenderereignis. | |
| Besprechungszeiten suchen | Ruft Besprechungszeiten und -orte basierend auf der Verfügbarkeit des Besprechungsorganisators und der Teilnehmer für die angegebene Zeit und die angegebenen Orte ab. | |
| Anhänge nach Ereignis-ID suchen | Rufe alle Anhänge im angegebenen Ereignis ab. | |
| Kalender nach ID suchen | Ruft die Kalenderdetails für die angegebene ID ab. | |
| Kalenderereignisse nach Anwender-ID suchen | Ruft die Liste der Ereignisobjekte im Postfach des Anwenders ab. | |
| Kalenderansichts-Stream suchen | Ruft die Liste der Besprechungseinträge für die angegebene Anwender-ID für den angegebenen Zeitraum ab. | |
| Stream mit Kalendern suchen | Ruft Details der Kalender aller Anwender ab. | |
| Event anhand ID suchen | Ruft die Kalenderereignisdetails für die angegebene ID ab. | |
| Zeitpläne suchen | Ruft die Liste der Zeitpläne ab. | |
| Abwesenheitseinstellungen suchen | Ruft die Details der Abwesenheitseinstellungen für die angegebenen Empfänger ab. | |
| Zeitzonen suchen | Ruft Details aller verfügbaren Zeitzonen ab. | |
| Kalenderereignis aktualisieren | Aktualisiert die Eigenschaften eines Ereignisobjekts. | |
| E-Mail-Verwaltung | Nachricht löschen | Löscht die Nachricht im Posteingang eines Anwenders oder aus einem anwenderdefinierten Ordner. |
| Sucht E-Mail-Ordner anhand der Anwender-ID | Ruft alle E-Mail-Ordner für eine angegebene Anwender-ID ab. | |
| Nachrichten anhand E-Mail-Ordner-ID suchen | Ruft alle Nachrichten in einem E-Mail-Ordner ab. | |
| Sucht Nachrichten anhand der Anwender-ID | Ruft alle Nachrichten im Posteingangsordner des Anwenders ab. | |
| E-Mail senden | Sendet eine E-Mail mit dem Nachrichtenbetreff und dem Nachrichtentext an die angegebene Empfängerliste. | |
| Automatische Postfach-Antwort festlegen | Legt die automatische Antwortnachricht des Anwenders für den angegebenen Zeitraum fest. | |
| Webhook-Verwaltung | Abonnement anhand ID suchen | Ruft Details des Webhook-Abonnements für die angegebene ID ab. |
| Stream mit Abonnements suchen | Ruft Details aller Webhook-Abonnements ab. | |
| Webhook-Abonnement verlängern | Verlängert das Abonnement des angegebenen Webhooks. | |
| Webhook abonnieren | Erstellt ein Webhook-Abonnement für die angegebene Ressource. | |
| Webhook abbestellen | Löscht das angegebene Webhook-Abonnement. | |
| Postfachverwaltung | Postfach erstellen | Erstellt gleichzeitig Postfächer und Benutzeraccounts. |
| Postfach löschen | Löscht oder deaktiviert Postfächer und Anwenderaccounts gleichzeitig. | |
| Postfach aktivieren | Aktiviert ein Postfach in Microsoft Exchange Online. Das Postfach kann sich im Status „Archiviert“ befinden. | |
| Postfach suchen | Ruft die Liste der Postfächer ab. |
Zum Ausführen dieser Aktionen sind folgende Berechtigungen erforderlich:
| Kategorie | Aktion | Berechtigungstyp | Berechtigungen (von den niedrigsten zu den höchsten Berechtigungen) |
|---|---|---|---|
| Kalenderverwaltung | Anhang in Kalenderereignis kopieren | Delegiert (Arbeits- oder Uni-Account) | Calendars.ReadWrite |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Kalenderereignis erstellen | Delegiert (Arbeits- oder Uni-Account) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Wiederkehrende Kalenderereignisse erstellen | Delegiert (Arbeits- oder Uni-Account) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Anhang löschen | Delegiert (Arbeits- oder Uni-Account) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Kalenderereignis löschen | Delegiert (Arbeits- oder Uni-Account) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Besprechungszeiten suchen | Delegiert (Arbeits- oder Uni-Account) | Kalender.Lesen, Kalender.LesenSchreiben | |
| Delegiert (privater Microsoft-Account) | Nicht unterstützt. | ||
| Anwendung | Nicht unterstützt. | ||
| Anhänge nach Ereignis-ID suchen | Delegiert (Arbeits- oder Uni-Account) | Calendars.Read | |
| Delegiert (privater Microsoft-Account) | Calendars.Read | ||
| Anwendung | Calendars.Read | ||
| Kalender nach ID suchen | Delegiert (Arbeits- oder Uni-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | |
| Delegiert (privater Microsoft-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | ||
| Anwendung | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | ||
| Kalenderereignisse nach Anwender-ID suchen | Delegiert (Arbeits- oder Uni-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | |
| Delegiert (privater Microsoft-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | ||
| Anwendung | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | ||
| Kalenderansichts-Stream suchen | Delegiert (Arbeits- oder Uni-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | |
| Delegiert (privater Microsoft-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | ||
| Anwendung | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | ||
| Stream mit Kalendern suchen | Delegiert (Arbeits- oder Uni-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.Lesen.Freigegeben, Kalender.LesenSchreiben | |
| Delegiert (privater Microsoft-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.Lesen.Freigegeben, Kalender.LesenSchreiben | ||
| Anwendung | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | ||
| Event anhand ID suchen | Delegiert (Arbeits- oder Uni-Account) | Kalender.LesenBasic, Kalender.Lesen | |
| Delegiert (privater Microsoft-Account) | Kalender.LesenBasic, Kalender.Lesen | ||
| Anwendung | Kalender.LesenBasic, Kalender.Lesen | ||
| Zeitpläne suchen | Delegiert (Arbeits- oder Uni-Account) | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | |
| Delegiert (privater Microsoft-Account) | Nicht unterstützt. | ||
| Anwendung | Kalender.LesenBasic, Kalender.Lesen, Kalender.LesenSchreiben | ||
| Abwesenheitseinstellungen suchen | Delegiert (Arbeits- oder Uni-Account) | Mail.Lesen, Mail.Lesen.Freigegeben | |
| Delegiert (privater Microsoft-Account) | E-Mail.Lesen | ||
| Anwendung | E-Mail.Lesen | ||
| Zeitzonen suchen | Delegiert (Arbeits- oder Uni-Account) | Anwender.Lesen, Anwender.LesenGrundlegend.Alle | |
| Delegiert (privater Microsoft-Account) | Anwender.Lesen | ||
| Anwendung | Benutzer.Lesen.Alle | ||
| Kalenderereignis aktualisieren | Delegiert (Arbeits- oder Uni-Account) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| E-Mail-Verwaltung | Nachricht löschen | Delegiert (Arbeits- oder Uni-Account) | Mail.Lesen/Schreiben |
| Delegiert (privater Microsoft-Account) | Mail.Lesen/Schreiben | ||
| Anwendung | Mail.Lesen/Schreiben | ||
| Sucht E-Mail-Ordner anhand der Anwender-ID | Delegiert (Arbeits- oder Uni-Account) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Anwendung | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Nachrichten anhand E-Mail-Ordner-ID suchen | Delegiert (Arbeits- oder Uni-Account) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Anwendung | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Sucht Nachrichten anhand der Anwender-ID | Delegiert (Arbeits- oder Uni-Account) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Anwendung | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| E-Mail senden | Delegiert (Arbeits- oder Uni-Account) | Mail.Senden | |
| Delegiert (privater Microsoft-Account) | Mail.Senden | ||
| Anwendung | Mail.Senden | ||
| Automatische Postfach-Antwort festlegen | Delegiert (Arbeits- oder Uni-Account) | Postfacheinstellungen.LesenSchreiben | |
| Delegiert (privater Microsoft-Account) | Postfacheinstellungen.LesenSchreiben | ||
| Anwendung | Postfacheinstellungen.LesenSchreiben | ||
| Postfachverwaltung | Postfach erstellen | Diese Aktionen verwenden PowerShell-Cmdlets und erfordern daher keine API-Berechtigungen. | |
| Postfach löschen | |||
| Postfach aktivieren | |||
| Postfach suchen | |||
Microsoft Kontoanforderungen
Für Microsoft Exchange Online-Spoke muss eine Anwendung über das Azure-Portal Microsoft ] registriert werden, um OAuth 2.0-Token zu generieren.
Alias-Anforderungen für Verbindungen und Anmeldeinformationen
IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.
Informationen zum Einrichten der Spoke finden Sie unter Microsoft Exchange Online-Spoke einrichten.