Microsoft Exchange Online スポーク
Microsoft Exchange Online スポーク は Microsoft Exchange Online でカレンダーとメールを作成して管理します。ユーザーとグループを作成、管理、または削除するには、 Microsoft Azure AD スポークを使用します。
ストアでアプリを要求する
ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。
スポークバージョン
Microsoft Exchange Online スポーク v3.11.0 が最新バージョンです。
スポークの依存関係
アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
- ServiceNow 統合ハブアクションステップ:REST (com.glide.hub.action_step.rest)
- ServiceNow 統合ハブランタイム (com.glide.hub.integration.runtime)
- ServiceNow フローデザイナー - 動的入力 (com.glide.hub.dynamic_inputs)
- 複合オブジェクト (com.glide.cobject)
- ServiceNow 統合ハブアクションテンプレート - データストリーム (com.glide.hub.action_type.datastream)
- リモートテーブル (com.glide.script.vtable)
- システムインポートデータソース (com.glide.system_import_data_source)
- iHUB スポークユーティリティパック (com.snc.ihub_spoke_util_pack)
サポートされているバージョン
MicrosoftGraph REST API v1.0
スポークモジュール
| モジュール | 説明 |
|---|---|
| イベント | Microsoft Exchange Online のイベントのリストを表示します。 |
| サブスクリプション | Microsoft Exchange Online のサブスクリプションのリストを表示します。 |
| Webhook レジストリ | Microsoft Exchange Online の Webhook レジストリのリストを表示します。 |
| カレンダー | Microsoft Exchange Online のカレンダーのリストを表示します。 |
| カレンダーイベント変換データ | データソースのレコードリストを表示します。 |
スポークのフロー
| フロー | 説明 |
|---|---|
| サブスクリプションを更新 | すべてのサブスクリプションレコードを取得し、更新が必要な場合は有効期限に基づいてサブスクリプションを更新します。サブスクリプションのステータスが「削除中」としてマークされている場合、そのレコードは削除され、更新の対象にはなりません。 |
スポークのサブフロー
| カテゴリ | サブフロー | 説明 |
|---|---|---|
| Webhook 管理 | イベントサブスクリプションを確認 | 指定されたイベントリソース、通知 URL、および変更タイプを含む Webhook サブスクリプションが存在するかどうかを確認します。 |
| サブスクリプションレコードを作成または更新 | 指定されたサブスクリプションレコードが Microsoft Exchange Online に存在するかどうかを確認し、存在する場合はサブスクリプションレコードを更新します。サブスクリプションレコードが存在しない場合は、新しいサブスクリプションレコードが作成されます。 | |
| リソースのサブスクリプションを作成または更新 | 指定されたリソースのサブスクリプションをチェックします。指定されたリソースのサブスクリプションが存在しない場合は、新しいサブスクリプションが作成されます。 注: このサブフローは、ワークスペースカレンダーの同期 プラグインが既にインストールされている場合にのみ使用できます。 |
|
| サブスクリプションを削除 | 指定されたサブスクリプションが指定されたアプリケーションにのみ関連付けられている場合、そのサブスクリプションを削除します。 | |
| 削除されたサブスクリプションを再作成 | 関連付けられたサブスクリプションレコードの詳細を使用して、削除された Webhook サブスクリプションを再作成します。 | |
| サブスクリプションライフサイクル管理 | Webhook サブスクリプションのライフサイクルを管理します。 | |
| カレンダー管理 | カレンダー同期 | [Exchange Online 予定表イベント変換済みデータ] テーブルからイベントを取得し、取得したイベントを Microsoft Exchange Online イベントテーブルに追加して、カレンダーを同期させます。ユーザーの指定したカレンダーに有効なサブスクリプションが存在しない場合は、サブスクリプションを作成します。 |
| イベントレコードの作成または更新 | 特定の既存のイベントレコードをチェックし、指定されたプロパティで更新します。指定されたイベントレコードが存在しない場合は、新しいイベントレコードが作成されます。 | |
| カレンダースケジュールイベントを削除 | Microsoft Exchange Online の指定されたイベントとイベントテーブルの関連するレコード、関連する添付ファイル、イベント出席者からの関連するレコード、およびイベントからサブスクリプションへの m2m テーブルを削除します。 | |
| イベントレコードを削除 | イベントテーブルと関連する添付ファイルの指定されたイベントレコード、イベント出席者からの関連するレコード、およびイベントからサブスクリプションへの m2m テーブルを削除します。 | |
| イベントライフサイクル管理 | イベント詳細を取得し、イベントのレコード、出席者、イベントからサブスクリプションへの m2m テーブルを適宜更新します。 | |
| イベントレコードへの添付ファイルを検索して更新 | Microsoft Exchange Online から特定のイベントレコードの添付ファイルを取得して更新します。 | |
| カレンダースケジュールの変更を検索して更新 | 指定されたイベントレコードのイベントの詳細を取得して更新します。 | |
| イベントを同期 | [Exchange Online 予定表イベント変換済みデータ] テーブルのデータに基づいて、カレンダービューを同期します。 | |
| カレンダースケジュールイベントを更新 | Microsoft Exchange Online のイベントオブジェクトのプロパティ、およびイベントテーブルの関連するレコードを更新します。 |
- Microsoft Exchange Online Webhook レジストリテーブルを使用して、Webhook サブスクリプションのコールバック URL を生成し、シークレット値 (クライアントステータス) を保存します。
- [ステータス] フィールドが [アクティブ] に設定された状態で、Webhook サブスクリプションが Microsoft Exchange Online サブスクリプションテーブルに保存されていることを確認します。
スポークのアクション
| カテゴリ | アクション | 説明 |
|---|---|---|
| カレンダー管理 | 添付ファイルをカレンダーイベントにコピー | ServiceNow添付ファイルをExchangeカレンダーイベントにコピーします。 |
| カレンダーイベントを作成 | ユーザーのデフォルトカレンダーにイベントを作成し、イベントの開始時間と終了時間のタイムゾーンを指定します。 | |
| 繰り返し発生するカレンダーイベントを作成 | ユーザーのデフォルトカレンダーに繰り返し発生するイベントを作成し、イベントの開始時間と終了時間のタイムゾーンを指定します。 | |
| 添付ファイルを削除 | 指定されたイベントの特定の添付ファイルを削除します。 | |
| カレンダーイベントを削除 | カレンダーイベントを削除します。 | |
| 会議の時間を検索 | 指定された時間と場所での会議の主催者と出席者の空き状況に合わせて、会議の時間と場所を取得します。 | |
| イベント ID で添付ファイルを検索 | 指定されたイベント内のすべての添付ファイルを取得します。 | |
| ID でカレンダーを検索 | 指定された ID のカレンダーの詳細を取得します。 | |
| ユーザー ID でカレンダーイベントを検索 | ユーザーのメールボックス内のイベントオブジェクトのリストを取得します。 | |
| カレンダービューストリームを検索 | 指定されたユーザー ID について、指定された期間の会議エントリのリストを取得します。 | |
| カレンダーストリームを検索 | すべてのユーザーのカレンダーの詳細を取得します。 | |
| ID でイベントを検索 | 指定された ID のカレンダーイベントの詳細を取得します。 | |
| スケジュールを検索 | スケジュールのリストを取得します。 | |
| 不在の設定を検索 | 指定された受信者の不在設定の詳細を取得します。 | |
| タイムゾーンを検索 | 利用可能なすべてのタイムゾーンの詳細を取得します。 | |
| カレンダーイベントを更新 | イベントオブジェクトのプロパティを更新します。 | |
| メール管理 | メッセージを削除 | ユーザーの受信箱内またはカスタムフォルダーからメッセージを削除します。 |
| ユーザー ID でメールフォルダーを検索 | 指定されたユーザー ID のすべてのメールフォルダーを取得します。 | |
| メールフォルダー ID でメッセージを検索 | メールフォルダー内のすべてのメッセージを取得します。 | |
| ユーザー ID でメッセージを検索 | ユーザーの受信箱フォルダー内のすべてのメッセージを取得します。 | |
| メールを送信 | メッセージの件名とメッセージの本文を含むメールを、指定された受信者リストに送信します。 | |
| メールボックスの自動返信を設定 | 指定された期間のユーザーの自動返信メッセージを設定します。 | |
| Webhook 管理 | ID でサブスクリプションを検索 | 指定された ID の Webhook サブスクリプションの詳細を取得します。 |
| サブスクリプションストリームを検索 | すべての Webhook サブスクリプションの詳細を取得します。 | |
| Webhook サブスクリプションを更新 | 指定された Webhook のサブスクリプションを更新します。 | |
| Webhook を登録 | 指定されたリソースの Webhook サブスクリプションを作成します。 | |
| Webhook を登録解除 | 指定された Webhook サブスクリプションを削除します。 | |
| メールボックス管理 | メールボックスを作成 | メールボックスとユーザーアカウントを同時に作成します。 |
| メールボックスの削除 | メールボックスとユーザーアカウントを同時に削除し、無効化します。 | |
| メールボックスを有効化 | Microsoft Exchange Online でメールボックスを有効化します。メールボックスはアーカイブ済みの状態にすることができます。 | |
| メールボックスを検索 | メールボックスのリストを取得します。 |
| カテゴリ | アクション | 権限タイプ | 権限 (権限の低いものから順に) |
|---|---|---|---|
| カレンダー管理 | 添付ファイルをカレンダーイベントにコピー | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadWrite | ||
| カレンダーイベントを作成 | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadWrite | ||
| 繰り返し発生するカレンダーイベントを作成 | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadWrite | ||
| 添付ファイルを削除 | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadWrite | ||
| カレンダーイベントを削除 | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadWrite | ||
| 会議の時間を検索 | 委任済み (職場または学校のアカウント) | Calendars.Read, Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | ||
| アプリケーション | サポート対象外 | ||
| イベント ID で添付ファイルを検索 | 委任済み (職場または学校のアカウント) | Calendars.Read | |
| 委任済み (個人の Microsoft アカウント) | Calendars.Read | ||
| アプリケーション | Calendars.Read | ||
| ID でカレンダーを検索 | 委任済み (職場または学校のアカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | ||
| ユーザー ID でカレンダーイベントを検索 | 委任済み (職場または学校のアカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | ||
| カレンダービューストリームを検索 | 委任済み (職場または学校のアカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | ||
| カレンダーストリームを検索 | 委任済み (職場または学校のアカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.Read.Shared、Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.Read.Shared、Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | ||
| ID でイベントを検索 | 委任済み (職場または学校のアカウント) | Calendars.ReadBasic、Calendars.Read | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadBasic、Calendars.Read | ||
| アプリケーション | Calendars.ReadBasic、Calendars.Read | ||
| スケジュールを検索 | 委任済み (職場または学校のアカウント) | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | ||
| アプリケーション | Calendars.ReadBasic、Calendars.Read、Calendars.ReadWrite | ||
| 不在の設定を検索 | 委任済み (職場または学校のアカウント) | Mail.Read、Mail.Read.Shared | |
| 委任済み (個人の Microsoft アカウント) | Mail.Read | ||
| アプリケーション | Mail.Read | ||
| タイムゾーンを検索 | 委任済み (職場または学校のアカウント) | User.Read、User.ReadBasic.All | |
| 委任済み (個人の Microsoft アカウント) | User.Read | ||
| アプリケーション | User.Read.All | ||
| カレンダーイベントを更新 | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | ||
| アプリケーション | Calendars.ReadWrite | ||
| メール管理 | メッセージを削除 | 委任済み (職場または学校のアカウント) | Mail.ReadWrite |
| 委任済み (個人の Microsoft アカウント) | Mail.ReadWrite | ||
| アプリケーション | Mail.ReadWrite | ||
| ユーザー ID でメールフォルダーを検索 | 委任済み (職場または学校のアカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | ||
| アプリケーション | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | ||
| メールフォルダー ID でメッセージを検索 | 委任済み (職場または学校のアカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | ||
| アプリケーション | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | ||
| ユーザー ID でメッセージを検索 | 委任済み (職場または学校のアカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | ||
| アプリケーション | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | ||
| メールを送信 | 委任済み (職場または学校のアカウント) | Mail.Send | |
| 委任済み (個人の Microsoft アカウント) | Mail.Send | ||
| アプリケーション | Mail.Send | ||
| メールボックスの自動返信を設定 | 委任済み (職場または学校のアカウント) | MailboxSettings.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | MailboxSettings.ReadWrite | ||
| アプリケーション | MailboxSettings.ReadWrite | ||
| メールボックス管理 | メールボックスを作成 | これらのアクションでは PowerShell コマンドレットが使用されるため、API 権限は必要ありません。 | |
| メールボックスを削除 | |||
| メールボックスを有効化 | |||
| メールボックスを検索 | |||
利用可能な AI エージェント
Now Assist for スポークをインストールし、利用可能な AI エージェントの使用を開始します。詳細については、「Now Assist for スポーク」を参照してください。
- ServiceNowエージェントシステムでは、目標を実行するために、一連の大規模言語モデル (LLM) 命令と 1 つ以上のスタンドアロン AI エージェントで構成されるエージェントワークフローを作成できます。AI エージェントを追加して要件に従ってエージェントワークフローを作成し、必要なトリガーを提供する方法については、 Create an agentic workflow を参照してください。
他の利用可能な AI エージェントを検索して、エージェントワークフローに追加することもできます。詳細については、「Find AI agents」を参照してください。
- 必要なスポーク AI エージェントのクローンを作成し、要件に応じてカスタマイズできます。クローンの作成の詳細については、 Duplicate an AI agent を参照してください。
- AI エージェントの詳細については、 Now Assist AI agents を参照してください。
| AI エージェント | 説明 |
|---|---|
| Microsoft Exchange Online カレンダー管理 AI エージェント | カレンダーイベント管理、添付ファイルの処理、タイムゾーンの検索など、 Microsoft Exchange Online 内のカレンダーに関連するワークフローを自動化します。 |
| Microsoft Exchange Online ルーム管理 AI エージェント | 「ルームストリームを検索」など、 Microsoft Exchange Online 内のルーム管理に関連するワークフローを自動化します。 |
| Microsoft Exchange Online メタデータ取得管理 AI エージェント | ルームメタデータやタイムゾーンメタデータの検索など、 Microsoft Exchange Online 内のルームメタデータ管理に関連するワークフローを自動化します。 |
| Microsoft Exchange Online 会議スケジューラー AI エージェント | Microsoft Exchange Online内のカレンダー管理タスクを自動化します。これにより、ユーザーは利用可能な会議のタイムスロットを検索し、それに応じて会議を作成できます。 |
| Microsoft Exchange Online メールマネージャー | メールフォルダーとメッセージの検索、メッセージの削除、メールボックスの自動返信の設定など、 Microsoft Exchange Online 内のメール管理タスクを自動化します。 |
- Now Assistアプリケーションとともにインストールされた AI エージェントが、エージェント型ワークフローで使用されていない可能性があります。インスタンスで利用可能なすべてのエージェントを表示する方法については、「 AI エージェントの検索」を参照してください。
- インスタンスにインストールされていない可能性のあるエージェントを見つけるには、ServiceNow Store の AI エージェントマーケットプレイスにアクセスしてください。
Microsoftアカウント要件
Microsoft Exchange Online スポークで OAuth 2.0 トークンを生成するには、Microsoft Azure ポータルを使用してアプリケーションを登録する必要があります。
接続および資格情報エイリアスの要件
統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。
スポークの設定については、「 Microsoft Exchange Online スポーク を設定。
MID サーバー の要件
これらのアクションを使用するには、MID サーバーをセットアップし、PowerShell を使用するように設定する必要があります。Power Shell with EXO V2 モジュールがインストールされていることを確認する。このモジュールは、メールボックス管理アクションを実行するために必要です。Mailbox エイリアスに関連付けられた接続レコードを使用して、アクションを実行する場所およびMID サーバー選択属性を設定します。MID サーバーの詳細については、「MID サーバー」を参照してください。
このスポークの MID サーバー を設定するには、「 スポークの MID サーバー の設定」を参照してください。