Microsoft SharePoint Online スポーク
Microsoft SharePoint Online スポークは ServiceNow® インスタンスを Microsoft SharePoint Online と統合するため、ワークフロー の一部として事前定義されたさまざまなアクションを自動化できます。たとえば、データベースのレコードが更新されたときに Microsoft SharePoint Online のフォルダーの名前を変更できます。
ストアでアプリを要求する
ServiceNow Storeにアクセスして、利用可能なすべてのアプリを表示し、ストアに要求を送信する方法を確認してください。リリースされたすべてのアプリのリリースメモ情報については、「ServiceNow Store バージョンの履歴リリースノート」を参照してください。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。
スポークバージョン
Microsoft SharePoint Online スポークv 2.10.0 が最新バージョンです。
注:
Microsoft SharePoint Online スポークは、オンプレミス SharePoint をサポートしていません。
スポークの依存関係
アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
- ServiceNow 統合ハブ ランタイム (com.glide.hub.integration.runtime)
- ServiceNow 統合ハブ Action Step - REST (com.glide.hub.action_step.rest)
- 複合オブジェクト (com.glide.cobject)
- ServiceNow ワークフロースタジオ - 動的入力 (com.glide.hub.dynamic_inputs)
- ServiceNow 統合ハブ Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow 統合ハブアクションテンプレート - データストリーム (com.glide.hub.action_type.datastream)
注:
これらのプラグインの一部はライセンス可能な機能であり、スポーク実装以外で使用する場合は適切なライセンスが必要です。ライセンスの詳細については、アカウントマネージャーにお問い合わせください。
サポート対象のバージョン
Microsoft SharePoint アプリケーションプログラミングインターフェイス (API) バージョン v1。
スポークのフロー
Microsoft SharePoint Online スポークでは、Microsoft SharePoint Online タスクの自動化をデモするドラフト状況のサンプルフローが提供されます。サンプルフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。次の表は、利用可能なサンプルフローを示しています。
| フロー | 説明 |
|---|---|
| レコードの新しい添付ファイルによってフォルダーが作成され、添付ファイルがコピーされます | 添付ファイルがデータベーステーブルに作成されると、Microsoft SharePoint Online スポークにナレッジレコード用のフォルダーが作成されます。添付ファイルがフォルダーにコピーされます。 |
| ナレッジベースのサイトを作成 | ナレッジベースがデータベーステーブルに作成されると、フローは Microsoft SharePoint Online でそのサイトを作成します。 |
注:
- シングルサインオン (SSO) が設定されている場合は、[ログイン名でユーザー情報を検索] アクションを使用して、スポークアクションの実行が承認されていることを確認できます。
- フローデザイナーとアクションデザイナーは、フローまたはアクションを実行する前に、ユーザー認証チェックが実行されていることを確認する必要があります。
スポークのサブフロー
Microsoft SharePoint Online スポークでは、Microsoft SharePoint Online タスクの自動化をデモするドラフト状況のサンプルサブフローが提供されます。サブフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。
| サブフロー | 説明 |
|---|---|
| ユーザーを削除してからグループに追加 | Microsoft SharePoint Online グループからユーザーを削除し、新しいユーザーを追加します。 |
| モダンサイトを削除 (O365 グループなし) | 非 O365 グループ (コミュニケーションサイト) に関連付けられているモダンサイトを削除します。 |
| (O365 グループを含む) モダンサイトを削除のために送信 |
(O365 グループを含む) モダンサイトを削除のために送信します。
注: サイトが SharePoint アドミンポータルの削除されたサイトセクションに移動するまでに最大 30 分かかる場合があります。 |
注:
フローデザイナーとアクションデザイナーは、フローまたはアクションを実行する前に、ユーザー認証チェックが実行されていることを確認する必要があります。
スポークのアクション
Microsoft SharePoint Online スポークは、 ServiceNow インスタンスのトリガーに基づいてさまざまな Microsoft SharePoint Online タスクを自動化するアクションを提供します。
SharePoint Online 接続を使用して一部のアクションを実行し、SharePoint Graph 接続を使用して残りのアクションを実行できます。
次の表のアクションでは、SharePoint Online の接続および資格情報エイリアスレコードが使用されます。
| SharePoint Online の接続および資格情報エイリアスレコードが使用されるアクション | ||
|---|---|---|
| カテゴリ | アクション | 説明 |
| サイト管理 | モダンサイトを作成 | コミュニケーションサイトとグループに関連付けられていないチームサイトのタイプのモダンサイトを作成します。 |
| サブサイトを作成 | Sharepoint Online にサブサイトを作成します。テナントはルートの場所を決定します。 | |
| モダンサイトを削除 | 非 O365 グループに関連付けられているモダンサイト (コミュニケーションサイト) を削除します。 | |
| サブサイトを削除 | Sharepoint Online からサブサイトを削除します。使用する接続 URL によってルートの場所が決まります。 | |
| モダンサイト情報を検索 | 最新のサイトの詳細を取得します。 | |
| サイトの変更を検索 | クエリ条件に基づいてサイトの変更を取得します。 | |
| ロールのアサインを検索 | サイトで定義されているすべてのロールのアサインを取得します。 | |
| サイトコレクション ID を検索 | 特定のサイト ID を検索します。 | |
| サブサイトの詳細を検索 | サブサイトに関する情報を検索します。 | |
| サイト情報を更新 | Microsoft SharePoint Onlineサイトを更新します。 | |
| フォルダー管理 | フォルダーを作成 | Microsoft SharePoint Onlineサイトのドキュメントライブラリーにフォルダーを作成します。 |
| フォルダーを削除 | Microsoft SharePoint Onlineのフォルダーを削除します。 注: フォルダーが削除される前に警告または通知を受け取ることはありません。 |
|
| フォルダー内のファイルをリスト | フォルダー内のファイルのリストを取得します。 | |
| フォルダー内のフォルダーをリスト | フォルダー内のフォルダーのリストを取得します。 | |
| フォルダーを検索 | Microsoft SharePoint Online でフォルダーを検索し、フォルダーのプロパティを返します。たとえば、出力にはプロパティ「相対 URL」を含めることができます。 | |
| フォルダーの名前を変更 | Microsoft SharePoint Online内のフォルダーの名前を変更します。 | |
| グループとフォルダーを共有 | Microsoft SharePoint Online内のグループとフォルダーを共有します。グループはMicrosoft SharePoint Onlineテナントアカウントに属している必要があります。 | |
| ユーザーとフォルダーを共有 | Microsoft SharePoint Online 内のユーザーとフォルダーを共有します。ユーザーはMicrosoft SharePoint Onlineテナントアカウントに属している必要があります。 | |
| グループとのフォルダーの共有を解除 | グループからフォルダーへのアクセス権を削除します。グループはMicrosoft SharePoint Onlineテナントアカウントに属している必要があります。 | |
| ユーザーとのフォルダーの共有を解除 | ユーザーからフォルダーへのアクセス権を削除します。ユーザーはMicrosoft SharePoint Onlineテナントアカウントに属している必要があります。 | |
| ファイル管理 | Sharepoint ファイルをレコードに添付 | ServiceNowレコードにMicrosoft SharePoint Onlineファイルを添付します。 |
| ファイルをチェックイン | Microsoft SharePoint Online のファイルのステータスを「チェックイン」に設定します。ステータスが「チェックイン」に設定された後にファイルのバージョン番号を検索するには、[ファイルの詳細を検索] アクションを使用します。 注: ファイルは既にアップロードされているため、チェックインするファイルのステータスが更新されるだけです。 |
|
| ファイルをチェックアウト | Microsoft SharePoint Online のファイルのステータスを「チェックアウト」に設定します。ステータスが「チェックアウト」に設定された後にファイルのバージョン番号を検索するには、[ファイルの詳細を検索] アクションを使用します。 注: ファイルは既にダウンロードされているため、チェックアウトするファイルのステータスが更新されるだけです。 |
|
| 添付ファイルをフォルダーにコピー | ServiceNow 添付ファイルを Microsoft SharePoint Online フォルダーにコピーします。 | |
| ファイルをコピー | 新しい名前でファイルをコピーします。 | |
| テキストファイルを作成 | 指定した情報を使用してテキストファイルを作成します。 | |
| ファイルを削除 | Microsoft SharePoint Onlineのファイルを削除します。 | |
| ファイルの詳細を検索 | Microsoft SharePoint Online 内でファイルの詳細を検索します。 | |
| ファイルを移動 | ファイルをMicrosoft SharePoint Online内の別の場所に移動します。 | |
| グループとファイルを共有 | ファイルを Microsoft SharePoint Online 内のグループと共有します。グループはMicrosoft SharePoint Onlineテナントアカウントに属している必要があります。 | |
| ユーザーとファイルを共有 | Microsoft SharePoint Onlineユーザーとファイルを共有します。ユーザーはMicrosoft SharePoint Onlineテナントアカウントに属している必要があります。 | |
| グループとのファイルの共有を解除 | Microsoft SharePoint Online グループからファイルへのアクセス権を削除します。グループはMicrosoft SharePoint Onlineテナントアカウントに属している必要があります。 | |
| ユーザーとのファイルの共有を解除 | Microsoft SharePoint Online ユーザーからファイルへのアクセス権を削除します。ユーザーはMicrosoft SharePoint Onlineテナントアカウントに属している必要があります。 | |
| ユーザー管理 | ログイン名でユーザー情報を検索 | Microsoft SharePoint Online サイトでユーザーに関する情報を検索し、情報を返します。 |
| メールでユーザー情報を検索 | 指定された Microsoft SharePoint Online サイトから指定されたユーザーを検索し、そのアカウントに関する SharePoint 情報を返します。 | |
| ユーザーの SharePoint グループを検索 | Microsoft SharePoint Online サイトで、ユーザーがメンバーになっているすべてのグループに関する情報を検索し、情報を返します。 | |
| 検索管理 | 検索クエリの結果ストリームを検索 | SharePoint ルートサイトを検索し、指定した検索クエリに基づく結果を取得します。 |
| グループ管理 | サイトにロールを追加 | ロールを Microsoft SharePoint Online ユーザーまたはグループに追加します。 |
| グループにユーザーを追加 | ユーザーを Microsoft SharePoint Online サイトグループに追加します。 | |
| グループを作成 | Microsoft SharePoint Onlineサイトにグループを作成します。 | |
| グループを削除 | Microsoft SharePoint Onlineサイトのグループを削除します。 | |
| 名前でグループを検索 | Microsoft SharePoint Online 内のサイトの場所でグループを名前で検索します。サイトの場所が指定されていない場合、テナントのルートサイトが検索されます。 | |
| サイトからロールを削除 | グループまたはユーザーから権限を削除します。 | |
| グループからユーザーを削除 | Microsoft SharePoint Onlineサイトグループからユーザーを削除します。 | |
| グループオーナー (ユーザー) を更新 | グループオーナーとしてユーザーを更新します。 | |
| サイトグループ別に M365 メンバーを検索 | Microsoft SharePoint Onlineサイトグループに関連付けられているユーザーと M365 グループのリストを取得します。 | |
| リスト管理 | リストを作成 | タイトルと説明とともに、Microsoft SharePoint Online サイトにリストを作成します。 |
| サブスクリプションリストを作成 | リストの Webhook サブスクリプションを作成します。 | |
| ID でリストを削除 | Microsoft SharePoint Online サイト内のリストを ID に基づいて削除します。 | |
| ID でリストの詳細を検索 | Microsoft SharePoint Online サイト内のリストを ID で検索します。 | |
| タイトルでリスト ID を検索 | Microsoft SharePoint Online サイト内のリストをタイトルで検索します。 | |
| サイト内のリストを ID で更新 | Microsoft SharePoint Online サイト内のリストを ID に基づいて更新します。 | |
| リストアイテム管理 | リストアイテムを作成 | リスト内にリストアイテムを作成します。 |
| ID でリストアイテムを削除 | リスト ID とリストアイテム ID の両方に基づいて、リストアイテムを削除します。 | |
| ID でリストアイテムを検索 | リスト ID とリストアイテム ID の両方で、リストアイテムを検索します。 | |
| リスト内のリストアイテムを検索 | さまざまな形式のリストからアイテムのリストを取得します。 | |
| ID でリストアイテムを更新 | リストアイテムタイトルを ID に基づいて更新します。 | |
注:
フローデザイナーとアクションデザイナーは、フローまたはアクションを実行する前に、ユーザー認証チェックが実行されていることを確認する必要があります。
これらのアクションでは、SharePoint Graph 接続および資格情報エイリアスレコードが使用されます。
| SharePoint Graph の接続および資格情報エイリアスレコードが使用されるアクション | ||
|---|---|---|
| カテゴリ | アクション | 説明 |
| 変更管理 | 変更クエリプロパティを取得 | 変更ログに対して実行されるクエリを定義するために使用される、変更クエリプロパティを取得します。 |
| ドライブのデルタリンクトークンを取得 | ドライブの最新のデルタリンクトークンを取得します。 | |
| 次のトークンを取得 | [SharePoint リソースの次のリンクトークン] テーブルから次のリンクトークンを取得します。 | |
| ファイル管理 | ファイルのダウンロードリンクを取得 | ファイルのダウンロード URL を取得します。 |
| ファイルの権限を検索 | ファイルの権限を取得します。 | |
| ファイルを検索 | ドライブ内のすべてのファイルを取得します。 | |
| リスト管理 | サブスクリプションリストを作成 | リストの Webhook サブスクリプションを作成します。 |
| サブスクリプションリストを更新 | リストの Webhook サブスクリプションを更新します。 | |
| サブスクリプションリストを削除 | リストの Webhook サブスクリプションを削除します。 | |
| リストを取得 | SharePoint テナントからリストの詳細を取得します。 | |
| ドライブを検索 | サイトのすべてのドライブを取得します。 | |
| サイト管理 | O365 グループを含むモダンサイトを削除 | O365 グループ (チームサイト) に関連付けられているモダンサイトを削除のために送信します。関連付けられている 0365 グループを削除し、サイトを削除します。 注: 実行後、サイトが削除されるまでに最大 30 分かかる場合があります。 |
| モダンサイトグループ情報を検索 | モダンサイト (チームサイト) の関連付けられている O365 グループの詳細を取得します。 | |
| サイトコレクションを検索 | すべてのサイトコレクションを取得します。 | |
| サブサイトを検索 | サイトのすべてのサブサイトの詳細を取得します。 | |
| ルートサイトのサブスクリプションを作成 | ルートサイトの Webhook サブスクリプションを作成します。 | |
| サイト権限を検索 | サイトのすべての権限を取得します。 | |
| サイトを取得 | サイトの詳細を取得します。 | |
利用可能な AI エージェント
Now Assist for 統合ハブ をインストールし、利用可能な AI エージェントの使用を開始します。詳細については、「統合ハブ 用 Now Assist」を参照してください。
このスポークは、人間のような知能を模倣して ServiceNow インスタンスでタスクを実行するスタンドアロンの AI エージェントを提供します。
- ServiceNowエージェントシステムでは、目標を実行するために、一連の大規模言語モデル (LLM) 命令と 1 つ以上のスタンドアロン AI エージェントで構成されるエージェントワークフローを作成できます。AI エージェントを追加して要件に従ってエージェントワークフローを作成し、必要なトリガーを提供する方法については、 Create an agentic workflow を参照してください。
他の利用可能な AI エージェントを検索して、エージェントワークフローに追加することもできます。詳細については、「Find AI agents」を参照してください。
- 必要なスポーク AI エージェントのクローンを作成し、要件に応じてカスタマイズできます。クローンを作成する方法の詳細については、「Duplicate an AI agent」を参照してください。
- AI エージェントの詳細については、 Now Assist AI agents を参照してください。
利用可能な AI エージェントは次のとおりです。
| AI エージェント | 説明 |
|---|---|
| Microsoft SharePoint Online ファイル管理 AI エージェント | ユーザーまたはグループとのファイルの共有、ファイルのコピー、ファイルの移動、テキストファイルの作成、ファイルの詳細の取得、ファイル権限の管理などのファイル関連タスクを自動化します。 |
| Microsoft SharePoint Online リスト管理 AI エージェント | リストの管理、サブスクリプションの作成と更新、リストの詳細の取得、ワークフローの自動化などの SharePoint 操作を自動化します。 |
| Microsoft SharePoint Online サイト管理 AI エージェント | サイトの作成と削除、サイトコレクションの管理、サイト情報の取得、SharePoint ワークフローの自動化などの SharePoint 操作を自動化します。 |
| Microsoft SharePoint Online グループ管理 AI エージェント | グループに対するユーザーの追加または削除、グループの作成または削除、グループ所有権の更新、SharePoint サイト内のロールの管理などのグループ管理プロセスを自動化します。 |
| Microsoft SharePoint Online リストアイテム管理 AI エージェント | リストアイテムの作成、更新、削除、取得などの SharePoint 操作を自動化します。 |
| Microsoft SharePoint Online ユーザー管理 AI エージェント | ユーザーの SharePoint グループ、ログイン名別のユーザー情報、メール別のユーザー詳細を取得するなどのユーザー管理タスクを自動化します。 |
| Microsoft SharePoint Online フォルダー管理 AI エージェント | フォルダーの名前変更、フォルダーの作成、ユーザーまたはグループとのフォルダーの共有と共有解除、ファイルやフォルダーのリスト表示、フォルダーの削除などのフォルダー管理タスクを自動化します。 |
| Microsoft SharePoint Online 変更管理 AI エージェント | 「次のトークンを取得」アクションと「ドライブのデルタリンクトークンを取得」アクションを実行します。 |
| Microsoft SharePoint Online 検索管理 AI エージェント | 必要な検索クエリ結果を取得し、ユーザーがプロセスを簡素化できるようにします。 |
Now Assistアプリケーションとともにインストールされた AI エージェントが、エージェント型ワークフローで使用されていない可能性があります。利用可能なすべてのエージェントを表示する方法については、「 AI エージェントを検索する」を参照してください。
注:
AI エージェントを実行しているユーザーに、AI エージェントに関連付けられたテーブル内のデータにアクセスしたり、データに対して操作を実行したりするために必要なロールと権限があることを確認します。
SharePoint Online アカウントの要件
Microsoft SharePoint Online スポークでは、SharePoint Online アカウントでカスタムアプリを作成し、OAuth 2.0 トークンを生成する必要があります。「Microsoft Azure での OAuth アプリケーションの設定」を参照してください。
接続および資格情報エイリアスの要件
統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。
- 単一のテナント
- このスポークには、Microsoft SharePoint Online でのアクションを許可するための MicrosoftSharepointOnline エイリアスレコードが含まれます。単一テナントについて、Microsoft SharePoint Onlineの変更を認証するテナントレコードにあるエイリアスを選択します。
- 複数のテナント
- このスポークには、Microsoft SharePoint Online でのアクションを許可するための MicrosoftSharepointOnline エイリアスレコードが含まれます。サポートする各追加テナントサイトに、接続および資格情報エイリアスレコードを作成します。Microsoft SharePoint Online での変更を認可するテナントレコード内の適切なエイリアスを選択します。サポートする各追加テナントサイトに、接続および資格情報エイリアスレコードを作成します。Microsoft SharePoint Online での変更を認可するテナントレコード内の適切なエイリアスを選択します。。「複数のテナントのエイリアスを作成」を参照してください。
注:
スポークでは、デフォルトで 3 つのエイリアスレコードを使用できます。Sharepoint Online、SharePoint Graph、および SharePoint Graph ルートサイトのサブスクリプションです。各エイリアスレコードには、テナントを関連付ける必要があります。スポークで SharePoint Online、Graph、およびルートサブスクリプションのすべてのアクションを使用する場合は、Microsoft SharePoint Online スポークのテナントテーブルに 3 つのテナントレコードが作成されており、各テナントレコードがそれぞれのエイリアスレコードに関連付けられていることを確認します。
- 単一テナントの統合を構成する場合は、既存の MicrosoftSharepointOnline エイリアスレコードを使用します。
- Microsoft SharePoint Graph 接続エイリアスでのみ、複数のテナントを使用できます。