Microsoft OneDrive スポーク

  • リリースバージョン: Zurich
  • 更新日 2025年09月02日
  • 所要時間：12分

    • Microsoft OneDrive で、ファイルとフォルダーの管理とコラボレーションを自動化します。Microsoft OneDrive データを ServiceNow インスタンスに追加します。

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

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

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

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

    スポークバージョン

    Microsoft OneDrive スポーク v2.6.0 が最新バージョンです。

    スポークの依存関係

    アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。

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

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

    API バージョン v1

    スポークのフロー

    Microsoft OneDrive スポーク では、Microsoft OneDrive タスクの自動化をデモするドラフト状況のサンプルフローが提供されます。サンプルフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。利用可能なサンプルフローは次のとおりです。

    フロー 説明
    サブスクリプションを更新 サブスクリプションの有効期限を更新して、期限切れのサブスクリプションを更新します。

    スポークのサブフロー

    Microsoft OneDrive スポークでは、Microsoft OneDriveタスクの自動化をデモするドラフト状況のサンプルサブフローが提供されます。サンプルサブフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。利用可能なサンプルサブフローは次のとおりです。

    サブフロー 説明
    新しい OneDrive ファイルを ServiceNow にダウンロード リソースにアップロードされた新しいファイルを ServiceNow レコードにダウンロード
    Webhook に登録 データが変更されたときに通知を受信するリスナーアプリケーションを登録します。
    変更を同期 ドライブとその子に対する変更を経時的に追跡します。
    ドキュメントの最新 URL を取得 ドキュメントのシステム ID を入力として使用して、OneDrive のファイルの最新のパスを取得します。このサブフローを使用するには、対応する OneDrive 接続と資格情報が作成されており、OneDrive 認証トークンが利用可能である必要があります。
    Microsoft OneDrive からドキュメントを再接続 ドキュメントシステム ID、プロバイダー詳細システム ID、ターゲットテーブル名、ターゲットテーブルシステム ID、およびドキュメント名を使用して、Microsoft OneDrive からドキュメントの最新の Web URL と webdav URL を取得します。このサブフローを使用するには、対応する OneDrive 接続と資格情報が作成されており、OneDrive 認証トークンが利用可能である必要があります。

    スポークのアクション

    Microsoft OneDrive スポーク は、ServiceNow でイベントが発生したときに Microsoft OneDrive タスクを自動化するアクションを提供します。使用可能なアクションは次のとおりです。

    カテゴリ アクション 説明
    ドライブ管理 ドライブ情報を検索 特定のMicrosoft OneDriveドライブのメタデータを取得
    フォルダー管理 ファイルまたはフォルダーアイテムを移動 Microsoft OneDrive内のファイルまたはフォルダーをターゲットの場所に移動します。
    フォルダーを作成 Microsoft OneDriveにフォルダーを作成します。
    ファイルまたはフォルダー名を更新 ファイルまたはフォルダーのアイテムの名前を ID で更新します。
    ファイルまたはフォルダーアイテムを削除 Microsoft OneDriveからファイルまたはフォルダーを削除します。
    ファイル管理 ファイルをチェックイン ドライブアイテムをチェックインし、共有への招待を送信します。ファイルをチェックインすると、チェックインしたファイルに他のユーザーがアクセスできます。
    ファイルをチェックアウト OneDrive からドライブアイテムをチェックアウトします。ドライブアイテムをチェックアウトすると、他のユーザーはドキュメントを編集できません。ドキュメントをチェックインするまで、他のユーザーもドキュメントに加えた変更を表示できません。
    OneDrive ファイルを添付ファイルにコピー Microsoft OneDriveのファイルをServiceNowレコードの添付ファイルにコピーします。
    添付ファイルを OneDrive にコピー ServiceNowの添付ファイルレコードをMicrosoft OneDriveにコピーします。
    ファイルまたはフォルダーアイテムをコピー 新しい親アイテムまたは新しい名前を使用して、Microsoft OneDriveアイテム (子を含む) のコピーを非同期に作成します。
    アイテムを検索 パスやドライブアイテムのソースとソース ID からドライブアイテムのリストを取得します。
    ID でファイルまたはフォルダーアイテム情報を検索

    Microsoft OneDriveのファイルまたはフォルダー ID からファイルのメタデータ情報を取得します。
    パスでファイルまたはフォルダーアイテム情報を検索 Microsoft OneDriveのファイルパスからファイルのメタデータ情報を取得します。
    パスを使用して添付ファイルを OneDrive にコピー ServiceNow の添付ファイルレコードを OneDrive にコピーします。
    ファイルパスを使用して OneDrive ファイルを添付ファイルにコピー OneDrive のパスを使用するファイルを ServiceNow のレコードの添付ファイルにコピーします。
    OneDrive ファイルのバージョンを添付ファイルにコピー OneDrive のファイルを ServiceNow のレコードの添付ファイルにコピーします。
    ファイルのバージョンを削除 指定されたバージョンのファイルを OneDrive から削除します。
    ファイルのすべてのバージョンを検索 OneDrive のファイルのすべてのバージョンを取得します。
    ファイルバージョンを復元 指定されたファイルバージョンを復元し、このバージョンを最新にします。
    ファイルをアップロードして置換 既存のファイルの更新バージョンをアップロードするか、既存のファイルを新しいファイルに置き換えます。
    注:
    ファイルの最大サイズは 4 MB を超えることはできません。
    ドキュメントの検索 ファイルまたはフォルダーのアイテムを検索 アイテム名などのメタデータ属性に基づいて、ドライブアイテム (ファイルまたはフォルダー) を検索します。
    ドキュメント共有 協力者を追加 協力者とその権限をファイルまたはフォルダーに追加します。協力者は、Azure AD エイリアスまたはオブジェクト ID で識別できます。
    協力者を検索 Microsoft OneDrive内のファイルまたはフォルダーに関連付けられているすべての協力者の詳細をリストします。
    協力者を削除 Microsoft OneDriveのファイルまたはフォルダーから協力者を削除します。
    権限管理 権限を追加 ドライブアイテムの共有への招待を送信します。共有への招待によって、受信者はドライブアイテムにアクセスでき、オプションで共有リンクを含むメールを送信できます。
    共有リンクを作成 ドライブアイテムを他のユーザーと共有できる共有リンクを作成します。
    権限を削除 ドライブアイテムへのアクセスを削除します。
    権限を検索 ドライブアイテムの共有権限を取得します。
    権限を更新 サブスクリプションの有効期限を更新します。
    Webhook 管理 Webhook を登録 データが変更されたときに通知を送信するサブスクリプションを作成します。
    Webhook を登録解除 指定されたサブスクリプション ID を削除します。
    サブスクリプションの同期トークンを取得 指定されたサブスクリプション ID の最新の同期トークンを取得します。
    サブスクリプションを検索 アクティブなサブスクリプションのリストを取得します。
    サブスクリプションを更新 サブスクリプションの有効期限を更新します。
    変更を同期 ドライブとその子に対する変更を経時的に追跡します。

    利用可能な AI エージェント

    Now Assist for スポークをインストールし、利用可能な AI エージェントの使用を開始します。詳細については、「Now Assist for スポーク」を参照してください。

    このスポークは、人間のような知能を模倣して 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 OneDrive 共有管理 AI エージェント 協力者を追加または削除し、 Microsoft OneDrive内のファイルまたはフォルダーに対する権限を管理します。また、ファイルまたはフォルダーに関連付けられているすべての協力者の詳細をリストします。
    Microsoft OneDrive ドライブ管理 AI エージェント Microsoft OneDrive内の特定のドライブのメタデータを取得します。
    Microsoft OneDrive ファイル管理 AI エージェント Microsoft OneDrive内のファイル、ファイルバージョン、および添付ファイルを管理します。また、必要なファイルの詳細を取得します。
    Microsoft OneDrive フォルダー管理 AI エージェント Microsoft OneDrive内のフォルダーを管理します。
    Microsoft OneDrive 権限管理 AI エージェント ドライブアイテムの共有リンクを作成し、権限を管理します。
    AI エージェントをお探しですか?
    • Now Assistアプリケーションとともにインストールされた AI エージェントが、エージェント型ワークフローで使用されていない可能性があります。インスタンスで利用可能なすべてのエージェントを表示する方法については、「 AI エージェントの検索」を参照してください。
    • インスタンスにインストールされていない可能性のあるエージェントを見つけるには、ServiceNow Store の AI エージェントマーケットプレイスにアクセスしてください。
    注:
    AI エージェントを実行しているユーザーに、AI エージェントに関連付けられたテーブル内のデータにアクセスしたり、データに対して操作を実行したりするために必要なロールと権限があることを確認します。

    スポークモジュール

    双方向 Webhook をセットアップして、必須イベントに関する通知を受けることができます。ルーティングポリシーは、ServiceNow アプリに通知するために満たすべき条件を定義しています。これらの条件は、通知を受けたい OneDrive のイベントに基づいています。条件が満たされると、ルーティングポリシーが関連するサブフローをトリガーし、OneDrive タスクを自動化します。

    双方向 Webhook には別途セットアップが必要で、スポークアクションを使用しないで単独で使用できます。デフォルトで、OneDrive Webhooks アプリケーションが OneDrive スポークで利用可能になっており、次のモジュールが含まれています。

    モジュール 説明
    OneDrive 同期トークン OneDrive の同期 Token を表示できます。
    OneDrive Webhook レジストリ ServiceNow で OneDrive Webhook を作成および表示できます。
    OneDrive Webhook ルーティングポリシー ServiceNow で OneDrive Webhook のルーティングポリシーを作成および表示できます。また、ルーティングポリシーの条件を要件に応じてカスタマイズすることもできます。

    OneDrive Online アカウント要件

    Microsoft OneDrive スポークには、Microsoft Azure で作成したカスタムアプリが必要です。

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

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

    単一のテナント
    OneDrive スポークには、Microsoft OneDrive のアクションを承認するための OneDrive エイリアスレコードが含まれています。単一テナントについて、Microsoft OneDriveの変更を認証するテナントレコードにあるエイリアスを選択します。

    スポークの設定については、「 Microsoft OneDrive スポークの設定。

    MID サーバー の要件

    これらのアクションでは、インスタンスで、またはオプションで MID サーバー を介して実行できる REST 呼び出しを使用します。Microsoft OneDrive エイリアスに関連付けられた接続レコードを使用して、アクションを実行する場所を設定し、必要に応じて MID サーバー 選択属性を指定します。 詳細については「MID サーバー」を参照してください。

    このスポークの MID サーバー を設定するには、「 スポークの MID サーバー の設定」を参照してください。