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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む13読むのに数分
  • フレームワークを ドキュメントサービス と統合します Microsoft OneDrive

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

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

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

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

    スポークバージョン

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

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

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

    主な機能

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

    スポークの依存関係

    アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
    • 複合オブジェクト (com.glide.cobject)
    • IHUB スポークユーティリティパック (com.snc.ihub_spoke_util_pack)
    • マルチプロバイダー ドキュメントサービス フレームワーク (com.snc.multiprovider_documents)
    • リモートディレクトリ同期 (com.snc.remote_directory_sync)
    • ServiceNow Flow Designer - 動的入力 (com.glide.hub.dynamic_inputs)
    • ServiceNow IntegrationHub アクションステップ - REST (com.glide.hub.action_step.rest)
    • ServiceNow IntegrationHub 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 を取得 参照先のドキュメント ID の最新の URL 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 を削除 マルチプロバイダードキュメント [mp_document] テーブルとマルチプロバイダードキュメントバージョン [mp_document_version] テーブル内のドキュメント Microsoft OneDrive を削除し、対応するレコードを削除します。
    ドキュメントバージョン V2 を削除 両方のMicrosoft OneDrive ドキュメントの特定のバージョンを削除し、[マルチプロバイダードキュメント] のマルチプロバイダードキュメントバージョン [mp_document_version] テーブルのレコードを削除します。
    すべてのドキュメントバージョン V2 を取得 [マルチプロバイダードキュメント] のマルチプロバイダードキュメントバージョン [mp_document_version] テーブルから Microsoft OneDrive すべてのドキュメントバージョンを取得し、レコードを作成または更新します。このサブフローは、でサポートされている Microsoft OneDriveさまざまなソースからのドキュメントをサポートします。
    OneDrive V2 からドキュメントを取得 Microsoft OneDrive からドキュメントを指定されたドキュメント名でコピーします。また、マルチプロバイダードキュメント [mp_document] テーブルにレコードを作成し、そのすべてのバージョンを [マルチプロバイダードキュメント] のマルチプロバイダードキュメントバージョン [mp_document_version] テーブルに作成します。
    V2 から Microsoft OneDrive ドキュメントを再接続 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」を参照してください。

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