ドキュメントサービス Framework for Microsoft OneDrive

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：13分

    • ドキュメントサービス Framework を Microsoft OneDrive と統合します。

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

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

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

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

    スポークバージョン

    ドキュメントサービスフレームワーク用 Microsoft OneDrive スポーク v 1.2.2 が最新バージョンです。

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

    このスポークは、ドキュメントサービスフレームワーク用 Microsoft OneDrive スポーク V1.1 用にビルドされていますが、それ以降のバージョンと互換性がある可能性があります。

    主な機能

    Microsoft OneDrive Spoke for ドキュメントサービス Framework を使用すると、フローデザイナー は次のことを実行できます。
    • Microsoft OneDrive へのドキュメントのアップロード
    • 共同作業
    • バージョンの管理
    • ドキュメントのダウンロード

    スポークの依存関係

    アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
    • 複合オブジェクト (com.glide.cobject)
    • IHUB スポークユーティリティパック (com.snc.ihub_spoke_util_pack)
    • マルチプロバイダー ドキュメントサービス フレームワーク (com.snc.multiprovider_documents)
    • リモートディレクトリ同期 (com.snc.remote_directory_sync)
    • ServiceNow フローデザイナー - 動的入力 (com.glide.hub.dynamic_inputs)
    • ServiceNow 統合ハブアクションステップ - REST (com.glide.hub.action_step.rest)
    • ServiceNow 統合ハブ Runtime (com.glide.hub.integration.runtime)
    注:
    これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。

    スポークのサブフロー

    ドキュメントサービスフレームワーク用 Microsoft OneDrive スポークでは、ドキュメントサービスタスクの自動化をデモするサンプルサブフローが提供されます。サンプルサブフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。次の表に、V1 および V2 で利用可能なサンプルサブフローを示します。
    注:
    V2 サブフローのみが Microsoft SharePoint サイトをサポートしています。
    表 : 1. V1 サブフロー
    サブフロー 説明
    協力者をグループに追加 提供された CollaboratorID を [タイプ] で指定されたメンバーまたはオーナーとして追加します。
    ドキュメントの共同作業 Microsoft OneDrive のグループまたはユーザーにドキュメントを関連付けます。
    受信者タイプと共にドキュメントを共同作業 指定された受信者タイプにドキュメントを関連付け
    パスを使用して OneDrive からドキュメントをコネクト Microsoft OneDrive ドキュメントを接続します。
    OneDrive ドキュメントバージョンをコピー 指定されたバージョンのドキュメントを Microsoft OneDrive から ServiceNow インスタンスの添付ファイルにコピーします。
    ドキュメントを作成 ドキュメントを Microsoft OneDrive にコピーし、マルチプロバイダードキュメント [mp_document] テーブルにレコードを作成し、マルチプロバイダードキュメントバージョン [mp_document_version] テーブルにバージョンを追加します。
    グループを作成 Microsoft OneDrive で指定されたグループを作成し、マルチプロバイダー権限構成 [mp_permission_configuration] テーブルを更新します。
    ドキュメントを削除 Microsoft OneDrive 内のドキュメントを削除し、マルチプロバイダードキュメントバージョン [mp_document_version] テーブル内の対応するレコードを削除します。
    ドキュメントバージョンの削除 Microsoft OneDrive および ServiceNow インスタンス内のドキュメントの指定されたバージョンを削除し、マルチプロバイダードキュメントバージョン [mp_document_version] テーブル内のレコードを削除します。
    ドキュメントのすべてのバージョンを取得 Microsoft OneDrive からドキュメントのすべてのバージョンを取得し、マルチプロバイダードキュメントバージョン [mp_document_version] テーブルにレコードを作成および更新します。
    OneDrive からドキュメントを取得 Microsoft OneDrive からドキュメントを指定されたドキュメント名でコピーします。また、マルチプロバイダードキュメント [mp_document] テーブル、およびマルチプロバイダードキュメントバージョン [mp_document_version] テーブルのすべてのドキュメントバージョンに、レコードを作成します。
    ドキュメントバージョンを復元 ドキュメントを Microsoft OneDrive のバージョンに復元します。
    協力者を同期 マルチプロバイダー協力者 [mp_collaborators] テーブル内のすべての Microsoft Azure ユーザーを同期します。

    ユーザーが削除または更新されると、マルチプロバイダー協力者 [mp_collaborators] テーブル内のユーザーのレコードがチェックされ、存在する場合はレコードが削除または更新されます。

    ユーザーが新しく追加されると、 マルチプロバイダードキュメントの下にあるマルチプロバイダー協力者 [mp_collaborators] テーブルにエントリが作成されます。

    注:
    [協力者を同期] という名前のスケジュール済みジョブは、 協力者を同期するためのサブフローをトリガーします。利用可能な [スクリプトを実行] オプションから選択できます。デフォルトのオプションは [オンデマンド] です。ジョブは設定されたスケジュールに基づいて実行され、それに応じて協力者が同期されます。詳細については、「Automatically run a script of your choosing」を参照してください。
    協力者レコードを削除 指定された協力者レコードをマルチプロバイダー協力者 [mp_collaborators] テーブルから削除します。
    ドキュメントのコンテンツを更新 指定されたドキュメントを、ドキュメント ID に対応する Microsoft OneDrive 内の指定された添付ファイルで更新します。添付ファイル名は、Microsoft OneDrive 内のドキュメントの名前と一致する必要があります。
    大きいファイルをアップロード 添付ファイルを Microsoft OneDrive にアップロードします。ファイルの最大サイズは 60 MB を超えることはできません。
    最新 URL を取得 Microsoft OneDrive 内のドキュメントへの最新の URL を取得します。
    Microsoft OneDrive からのドキュメントの再接続 Microsoft OneDrive 内のドキュメントに再接続します。
    注:
    サブフローを使用する前に、対応する Microsoft OneDrive 接続と資格情報が作成されており、Microsoft OneDrive 認証トークンが利用可能であることを確認してください。
    表 : 2. V2 サブフロー
    サブフロー 説明
    ドキュメントの最新 URL V2 を取得 最新の URL を、参照先のドキュメント ID の Microsoft OneDrive から取得します。
    ドキュメントのコンテンツ V2 を更新 マルチプロバイダードキュメント sys_id テーブルのドキュメント ID に対応する Microsoft OneDrive 内の添付コンテンツがある指定のドキュメントを更新します。添付ファイル名は、Microsoft OneDrive 内のドキュメントの名前と一致する必要があります。
    ドキュメント V2 の共同作業 指定された受信者タイプにドキュメントを関連付けます。
    パス V2 を使用して OneDrive からドキュメントをコネクト [マルチプロバイダードキュメント] で追跡も可能な Microsoft OneDrive ドキュメントを接続します。
    OneDrive ドキュメントバージョン V2 をコピー 指定されたバージョンのドキュメントを Microsoft OneDrive から ServiceNow インスタンスの添付ファイルにコピーします。
    ドキュメント V2 を作成 ドキュメントを Microsoft OneDrive にコピーし、マルチプロバイダードキュメントのマルチプロバイダードキュメント [mp_document] テーブル、およびマルチプロバイダードキュメントバージョン [mp_document_version] テーブルにレコードを作成します。
    ドキュメント V2 を削除 Microsoft OneDrive 内のドキュメントを削除し、マルチプロバイダードキュメント [mp_document] テーブル、およびマルチプロバイダードキュメントバージョン [mp_document_version] テーブルの対応するレコードを削除します。
    ドキュメントバージョン V2 を削除 Microsoft OneDrive 内の特定バージョンのドキュメントを削除し、マルチプロバイダードキュメントの下のマルチプロバイダードキュメントバージョン [mp_document_version] テーブルのレコードを削除します。
    すべてのドキュメントバージョン V2 を取得 Microsoft OneDrive からドキュメントのすべてのバージョンを取得し、マルチプロバイダードキュメントの下のマルチプロバイダードキュメントバージョン [mp_document_version] テーブルにレコードを作成、または更新します。このサブフローは、Microsoft OneDrive でサポートされているさまざまなソースからのドキュメントをサポートしています。
    OneDrive V2 からドキュメントを取得 Microsoft OneDrive からドキュメントを指定されたドキュメント名でコピーします。また、マルチプロバイダードキュメントの下の、マルチプロバイダードキュメント [mp_document] テーブル、およびマルチプロバイダードキュメントバージョン [mp_document_version] テーブルのすべてのドキュメントバージョンに、レコードを作成します。
    Microsoft OneDrive V2 からのドキュメントの再接続 Microsoft OneDrive 内のドキュメントに再接続します。
    注:
    サブフローを使用する前に、対応する Microsoft OneDrive 接続と資格情報が作成されており、Microsoft OneDrive 認証トークンが利用可能であることを確認してください。
    ドキュメントバージョン V2 を復元 ドキュメントを Microsoft OneDrive で提供されたバージョンに復元します。
    協力者を同期 V2 すべての Microsoft Azure ユーザーを、マルチプロバイダードキュメントの協力者 [mp_collaborators] テーブルに同期します。
    サイズの大きいファイル V2 をアップロード 添付ファイルを Microsoft OneDrive にアップロードします。ファイルの最大サイズは 60 MB を超えることはできません。
    ドキュメントコラボレーションを削除 Microsoft OneDrive ドキュメントのコラボレーションを削除します。
    ドキュメントコラボレーションを更新 Microsoft OneDrive ドキュメントのコラボレーションを更新します。
    注:
    V2 サブフローは、[ドキュメントを作成 V2] または [ドキュメントをコネクト V2] サブフローを使用してプラットフォームに添付されたドキュメントに対してのみ機能します。
    。

    スポークのアクション

    Microsoft OneDrive Spoke for ドキュメントサービス Framework では、ServiceNow でイベントが発生したときに ドキュメントサービス タスクを自動化するアクションが提供されます。次の表に、利用可能なサンプルアクションを示します。

    アクション 説明
    協力者レコードを削除 指定された協力者レコードをマルチプロバイダー協力者 [mp_collaborators] テーブルから削除します。
    ドキュメントを削除 マルチプロバイダードキュメントテーブル [mp_document] からドキュメントレコードを削除します。
    ドキュメントおよびバージョンを削除 マルチプロバイダードキュメントバージョン [mp_document_version] テーブルから、指定されたドキュメントとそのバージョンすべてを削除します。
    ドキュメントバージョンを削除 マルチプロバイダードキュメントバージョン [mp_document_version] テーブルから、ドキュメントの指定されたバージョンを削除します。
    ドキュメントのバージョンを削除 指定されたドキュメントのすべてのバージョンを削除します。
    ターゲットレコードの存在を確認 指定されたターゲットテーブルにターゲットレコードが存在するかどうかをチェックします。
    ファイルおよびフォルダーを検索 選択されたソースとソース ID のために指定されたフォルダー ID のファイルとフォルダーのリストを取得します。ソースが選択されていない場合は、デフォルトでルートフォルダーの内容が一覧表示されます。
    クエリ文字列ストリームに基づいてサイトを検索 指定したクエリ文字列を満たすすべてのサイトを一覧表示します。
    デルタトークンを更新 システムプロパティ deltaToken を、指定されたデルタトークンで更新します。

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

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

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