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 Benutzer- und Gruppenverwaltung kann nur mit Microsoft Azure AD und nicht mit Microsoft Exchange Online-Spokedurchgeführt werden.
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 v 3.6.4 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-Aktionsvorlage – Datenstrom (com.glide.hub.action_type.datastream)
- Remotetabellen (com.glide.script.vtable)
- Datenquelle „Systemimport“ (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 die Microsoft Exchange Online-Anwendung zu Ihrer Instanz hinzu und enthält die folgenden Module:
| Modul | Beschreibung |
|---|---|
| Ereignisse | Zeigt die Liste der Events 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 basierend auf der Ablaufzeit eine Verlängerung erforderlich ist. Wenn der Status eines Abonnements als „Wird gelöscht“ markiert ist, wird der Datensatz gelöscht und kann nicht verlängert werden. |
Spoke-Unterabläufe
Die -Spoke stellt Subflows im Status „Veröffentlicht“ bereit, die in den Service Microsoft Exchange Online integriert werden sollen. Diese Subflows können als Teil anderer Subflows und Flows verwendet werden.
| Kategorie | Subflows | Beschreibung |
|---|---|---|
| Webhook-Verwaltung | Aktivieren Sie das Ereignisabonnement | Überprüft, ob ein Webhook-Abonnement mit der angegebenen Ereignisressource oder Benachrichtigungs-URL und dem Change-Typ vorhanden ist. |
| Erstellen oder aktualisieren Sie einen Abonnementdatensatz | Ü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. | |
| Erstellen oder aktualisieren Sie Abonnements für Ressourcen | Prüft auf die 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 Calendar Synchronization 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 anhand der Details aus dem zugehörigen Abonnementdatensatz neu. | |
| Abonnement-Lebenszyklusverwaltung | Verwaltet den Lebenszyklus eines Webhook-Abonnements. | |
| Kalenderverwaltung | Kalendersynchronisierung | Synchronisiert den Kalender, indem Ereignisse aus der Tabelle „Transformierte Daten für Exchange Online-Kalenderereignisse“ abgerufen und die abgerufenen Ereignisse der Tabelle Microsoft Exchange Online „ Ereignisse“ hinzugefügt werden. Es wird ein Abonnement erstellt, wenn für den angegebenen Kalender des Benutzers kein gültiges Abonnement vorhanden ist. |
| Erstellen oder aktualisieren Sie einen Event-Datensatz | Sucht nach dem spezifischen vorhandenen Event-Datensatz und aktualisiert ihn mit den angegebenen Eigenschaften. Wenn der angegebene Event-Datensatz nicht vorhanden ist, wird ein neuer Event-Datensatz 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-m2m-Abonnementtabellen. | |
| Löschen Sie den Event-Datensatz | Löscht den angegebenen Event-Datensatz aus Event-Tabellen und die zugehörigen Anhänge, zugehörige Datensätze von Event-Teilnehmern und Event-zu-Abonnement-m2m-Tabellen. | |
| Event-Lebenszyklusverwaltung | Ruft die Ereignisdetails ab und aktualisiert die Datensätze in den Tabellen „Ereignis“, „Teilnehmer“, „Ereignis“ bis „m2m-Abonnement“ entsprechend. | |
| Anhänge an Event-Datensatz suchen und aktualisieren | Ruft die Anhänge eines bestimmten Event-Datensatzes aus Microsoft Exchange Online ab und aktualisiert sie. | |
| Suchen und aktualisieren Sie die Änderung der Kalenderplanung | Ruft die Ereignisdetails eines angegebenen Ereignisdatensatzes ab und aktualisiert sie. | |
| Ereignisse synchronisieren | Synchronisiert die Kalenderansicht basierend auf den Daten aus der Tabelle „Transformierte Daten für Exchange Online-Kalenderereignisse“. | |
| Aktualisieren Sie das Kalenderplanungsereignis | Aktualisiert die Eigenschaften eines Event-Objekts in Microsoft Exchange Online und den zugehörigen Datensatz in der Event-Tabelle. |
Hinweis:
- Verwenden Sie die Microsoft Exchange Online-Webhook-Registrierungstabelle, um eine Rückruf-URL zu generieren und den geheimen Wert (Client-Status) für Webhook-Abonnements zu speichern.
- Stellen Sie sicher, dass das Webhook-Abonnement in der Tabelle „Microsoft Exchange Online-Abonnements“ gespeichert ist und das Feld Status auf Aktiv festgelegt ist.
Spoke-Aktionen
Microsoft Exchange Online-Spoke bietet Aktionen zum Automatisieren von Kalender- und E-Mail-Aufgaben, wenn ein Incident in der Instanz ServiceNow erstellt wird.
| Kategorie | Aktion | Beschreibung |
|---|---|---|
| Kalenderverwaltung | Anhang in Kalenderereignis kopieren | Kopiert einen Anhang ServiceNow in ein Kalenderereignis Exchange. |
| Kalenderereignis erstellen | Erstellt ein Event im Standardkalender des Benutzers und gibt die Zeitzone für die Start- und Endzeit des Events an. | |
| Wiederkehrende Kalenderereignisse erstellen | Erstellt ein wiederkehrendes Ereignis im Standardkalender des Benutzers und gibt die Zeitzone für die Start- und Endzeit des Ereignisse 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 Event-Objekts. | |
| E-Mail-Verwaltung | Nachricht löschen | Löscht die Nachricht im Posteingang eines Anwenders oder aus einem benutzerdefinierten Ordner. |
| Sucht E-Mail-Ordner nach Anwender-ID | Ruft alle E-Mail-Ordner für eine angegebene Anwender-ID ab. | |
| Sucht Nachrichten nach E-Mail-Ordner-ID | Ruft alle Nachrichten in einem E-Mail-Ordner ab. | |
| Sucht Nachrichten nach Anwender-ID | Ruft alle Nachrichten im Posteingangsordner des Anwenders ab. | |
| E-Mail senden | Sendet eine E-Mail mit Betreff und Nachrichtentext an die angegebene Empfängerliste. | |
| Automatische Postfach-Antwort festlegen | Legt die automatische Antwortnachricht des Benutzers 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 Postfächer und Benutzerkonten gleichzeitig. |
| Postfach löschen | Löscht oder deaktiviert Postfächer und Benutzerkonten gleichzeitig. | |
| Postfach aktivieren | Aktiviert ein Postfach in Microsoft Exchange Online. Das Postfach kann sich in einem archivierten Status 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 geringsten bis zu den höchsten Berechtigungen) |
|---|---|---|---|
| Kalenderverwaltung | Anhang in Kalenderereignis kopieren | Delegiert (Arbeits- oder Schulkonto) | Calendars.ReadWrite |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Kalenderereignis erstellen | Delegiert (Arbeits- oder Schulkonto) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Wiederkehrende Kalenderereignisse erstellen | Delegiert (Arbeits- oder Schulkonto) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Anhang löschen | Delegiert (Arbeits- oder Schulkonto) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Kalenderereignis löschen | Delegiert (Arbeits- oder Schulkonto) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| Besprechungszeiten suchen | Delegiert (Arbeits- oder Schulkonto) | Calendars.Read, Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Nicht unterstützt. | ||
| Anwendung | Nicht unterstützt. | ||
| Anhänge nach Ereignis-ID suchen | Delegiert (Arbeits- oder Schulkonto) | Calendars.Read | |
| Delegiert (privater Microsoft-Account) | Calendars.Read | ||
| Anwendung | Calendars.Read | ||
| Kalender nach ID suchen | Delegiert (Arbeits- oder Schulkonto) | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | ||
| Anwendung | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | ||
| Kalenderereignisse nach Anwender-ID suchen | Delegiert (Arbeits- oder Schulkonto) | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | ||
| Anwendung | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | ||
| Kalenderansichts-Stream suchen | Delegiert (Arbeits- oder Schulkonto) | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | ||
| Anwendung | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | ||
| Stream mit Kalendern suchen | Delegiert (Arbeits- oder Schulkonto) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite | ||
| Anwendung | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | ||
| Event anhand ID suchen | Delegiert (Arbeits- oder Schulkonto) | Calendars.ReadBasic, Calendars.Read | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadBasic, Calendars.Read | ||
| Anwendung | Calendars.ReadBasic, Calendars.Read | ||
| Zeitpläne suchen | Delegiert (Arbeits- oder Schulkonto) | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Nicht unterstützt. | ||
| Anwendung | Kalender.ReadBasic, Kalender.Read, Kalender.ReadWrite | ||
| Abwesenheitseinstellungen suchen | Delegiert (Arbeits- oder Schulkonto) | Mail.Read, Mail.Read.Shared | |
| Delegiert (privater Microsoft-Account) | Mail.Lesen | ||
| Anwendung | Mail.Lesen | ||
| Zeitzonen suchen | Delegiert (Arbeits- oder Schulkonto) | Benutzer.Lesen, Benutzer.ReadBasic.All | |
| Delegiert (privater Microsoft-Account) | Benutzer.Lesen | ||
| Anwendung | Benutzer.Lesen.Alle | ||
| Kalenderereignis aktualisieren | Delegiert (Arbeits- oder Schulkonto) | Calendars.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Calendars.ReadWrite | ||
| Anwendung | Calendars.ReadWrite | ||
| E-Mail-Verwaltung | Nachricht löschen | Delegiert (Arbeits- oder Schulkonto) | Mail.LesenSchreiben |
| Delegiert (privater Microsoft-Account) | Mail.LesenSchreiben | ||
| Anwendung | Mail.LesenSchreiben | ||
| Sucht E-Mail-Ordner nach Anwender-ID | Delegiert (Arbeits- oder Schulkonto) | 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 nach E-Mail-Ordner-ID | Delegiert (Arbeits- oder Schulkonto) | 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 nach Anwender-ID | Delegiert (Arbeits- oder Schulkonto) | 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 Schulkonto) | Mail.Senden | |
| Delegiert (privater Microsoft-Account) | Mail.Senden | ||
| Anwendung | Mail.Senden | ||
| Automatische Postfach-Antwort festlegen | Delegiert (Arbeits- oder Schulkonto) | MailboxSettings.ReadWrite | |
| Delegiert (privater Microsoft-Account) | MailboxSettings.ReadWrite | ||
| Anwendung | MailboxSettings.ReadWrite | ||
| 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 von 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.