Microsoft OneDrive スポーク

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

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

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

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

スポークバージョン

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

スポークの依存関係

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

ServiceNow IntegrationHub アクションステップ：REST (com.glide.hub.action_step.rest)
ServiceNow IntegrationHub Runtime (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 の最新の同期トークンを取得します。
	サブスクリプションを検索	アクティブなサブスクリプションのリストを取得します。
	サブスクリプションを更新	サブスクリプションの有効期限を更新します。
	変更を同期	ドライブとその子に対する変更を経時的に追跡します。

スポークモジュール

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

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


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

OneDrive Online アカウント要件

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

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

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

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

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

MID サーバーの要件

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