Microsoft SharePoint Online スポーク

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む14読むのに数分

    • Microsoft SharePoint Online スポークは ServiceNow® インスタンスを Microsoft SharePoint Online と統合するため、Workflowの一部として事前定義されたさまざまなアクションを自動化できます。たとえば、データベースのレコードが更新されたときに Microsoft SharePoint Online のフォルダーの名前を変更できます。

    ストアでアプリを要求する

    ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

    統合ハブサブスクリプション

    このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - IntegrationHub の概要」を参照してください。

    スポークバージョン

    Microsoft SharePoint Online スポーク v 2.4.5 が最新バージョンです。

    注:
    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)
    • ServiceNow 統合ハブ ランタイム (com.glide.hub.integration.runtime)
    注:
    これらのプラグインの一部はライセンス可能な機能であり、スポーク実装以外で使用する場合は適切なライセンスが必要です。ライセンスの詳細については、アカウントマネージャーにお問い合わせください。

    サポートされているバージョン

    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 グループからユーザーを削除し、新しいユーザーを追加します。
    注:
    フローデザイナーとアクションデザイナーは、フローまたはアクションを実行する前に、ユーザー認証チェックが実行されていることを確認する必要があります。

    スポークのアクション

    Microsoft SharePoint Online スポークは、 ServiceNow インスタンスのトリガーに基づいてさまざまな Microsoft SharePoint Online タスクを自動化するアクションを提供します。

    SharePoint Online 接続を使用して一部のアクションを実行し、SharePoint Graph 接続を使用して残りのアクションを実行できます。

    次の表のアクションでは、SharePoint Online の接続および資格情報エイリアスレコードが使用されます。
    SharePoint Online の接続および資格情報エイリアスレコードが使用されるアクション
    カテゴリ アクション 説明
    サイト管理 サイトを作成 テナントのルートの場所に基づいて Microsoft SharePoint Online にサイトまたはサブサイトを作成します。
    サイトを削除 接続 URL で指定された場所に基づいて Microsoft SharePoint Online からサイトまたはサブサイトを削除します。[サイトの場所] 入力パラメーターに基づいてサブサイトが削除されます。
    サイトの変更を検索 クエリ条件に基づいてサイトの変更を取得します。
    ロールのアサインを検索 サイトで定義されているすべてのロールのアサインを取得します。
    サイトコレクション ID を検索 特定のサイト ID を検索します。
    サイトを検索 Microsoft SharePoint Online 内のサイトとサブサイトを検索します。
    サブサイトの詳細を検索 サブサイトに関する情報を検索します。
    サイト情報を更新 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 サイトでユーザーに関する情報を検索し、情報を返します。
    ユーザーの SharePoint グループを検索 Microsoft SharePoint Online サイトで、ユーザーがメンバーになっているすべてのグループに関する情報を検索し、情報を返します。
    グループ管理 サイトにロールを追加 ロールを Microsoft SharePoint Online ユーザーまたはグループに追加します。
    グループにユーザーを追加 ユーザーを Microsoft SharePoint Online サイトグループに追加します。
    グループを作成 Microsoft SharePoint Onlineサイトにグループを作成します。
    グループを削除 Microsoft SharePoint Onlineサイトのグループを削除します。
    名前でグループを検索 Microsoft SharePoint Online 内のサイトの場所でグループを名前で検索します。サイトの場所が指定されていない場合、テナントのルートサイトが検索されます。
    サイトからロールを削除 グループまたはユーザーから権限を削除します。
    グループからユーザーを削除 Microsoft SharePoint Onlineサイトグループからユーザーを削除します。
    グループオーナー (ユーザー) を更新 グループオーナーとしてユーザーを更新します。
    リスト管理 リストを作成 タイトルと説明とともに、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 の接続および資格情報エイリアスレコードが使用されるアクション
    カテゴリ アクション 説明
    Change Management 変更クエリプロパティを取得 変更ログに対して実行されるクエリを定義するために使用される、変更クエリプロパティを取得します。
    ドライブのデルタリンクトークンを取得 ドライブの最新のデルタリンクトークンを取得します。
    次のトークンを取得 [SharePoint リソースの次のリンクトークン] テーブルから次のリンクトークンを取得します。
    ファイル管理 ファイルのダウンロードリンクを取得 ファイルのダウンロード URL を取得します。
    ファイルの権限を検索 ファイルの権限を取得します。
    ファイルを検索 ドライブ内のすべてのファイルを取得します。
    リスト管理 サブスクリプションリストを作成 リストの Webhook サブスクリプションを作成します。
    サブスクリプションリストを更新 リストの Webhook サブスクリプションを更新します。
    サブスクリプションリストを削除 リストの Webhook サブスクリプションを削除します。
    リストを取得 SharePoint テナントからリストの詳細を取得します。
    ドライブを検索 サイトのすべてのドライブを取得します。
    サイト管理 サイトコレクションを検索 すべてのサイトコレクションを取得します。
    サブサイトを検索 サイトのすべてのサブサイトの詳細を取得します。
    ルートサイトのサブスクリプションを作成 ルートサイトの Webhook サブスクリプションを作成します。
    サイト権限を検索 サイトのすべての権限を取得します。
    サイトを取得 サイトの詳細を取得します。

    SharePoint Online アカウントの要件

    Microsoft SharePoint Online スポークでは、SharePoint Online アカウントでカスタムアプリを作成し、OAuth 2.0 トークンを生成する必要があります。「Microsoft Azure での OAuth アプリケーションの設定」を参照してください。

    接続および資格情報エイリアスの要件

    統合ハブ は、エイリアスを使用して、接続および資格情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の資格情報と接続情報プロファイルを構成する必要がなくなります。接続または資格情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。詳細については、「資格情報と接続情報」を参照してください。

    単一のテナント
    このスポークには、Microsoft SharePoint Online でのアクションを許可するための MicrosoftSharepointOnline エイリアスレコードが含まれます。単一テナントについて、Microsoft SharePoint Onlineの変更を認証するテナントレコードにあるエイリアスを選択します。
    複数のテナント
    このスポークには、Microsoft SharePoint Online でのアクションを許可するための MicrosoftSharepointOnline エイリアスレコードが含まれます。サポートする各追加テナントサイトに、接続および資格情報エイリアスレコードを作成します。Microsoft SharePoint Online での変更を認可するテナントレコード内の適切なエイリアスを選択します。「複数のテナントのエイリアスを作成」を参照してください。