Microsoft OneDrive for Businessコネクター

​

はじめに

Microsoft OneDrive for Businessは、ビジネス用オンラインファイル共有とパーソナルクラウドコンテンツ管理サービスです。OneDrive APIについての詳細は、https://msdn.microsoft.com/en-us/lib…/dn659752.aspxを参照してください。

OneDrive for Businessアカウントには、Data Centerから接続します。このトピックでは、OneDrive for Businessコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「コネクターを使用してDataSetを追加する」を参照してください。

​

必要条件

OneDrive for Businessアカウントに接続してDataSetを作成するには、以下が必要です。

• OneDrive for Businessクライアントシークレット
• Microsoftのユーザー名とパスワード

Microsoft Graphを使用する場合は、新しく登録したAppを使用するか、既存のAppを使用するかによって、redirect_uriを別のURLに設定する必要があります。

• 新しく登録したAppを使用する場合は、redirect_uriをhttps://oauth.domo.com/api/data/v1/oauth/providers/onedrive-business/exchangeに設定します。
• 既存のAppを使用する場合は、redirect_uriをhttps://oauth.domo.com/api/data/v1/oauth/providers/microsoft-onedrive-business/exchangeに設定します。

OneDrive for BusinessのクライアントID、クライアントシークレットを取得し、SharePoint Server 2016を使用してAppを登録する手順については、https://dev.onedrive.com/app-registration-server.htmを参照してください。

Microsoft GraphにAppを登録する手順については、https://docs.microsoft.com/en-us/onedrive/app-registration.htmを参照してください。

Microsoft OneDrive for Businessに接続して情報を取得するには、次のものが必要です。

• Microsoft Azure Appのインストール。

• クライアントIDとクライアントシークレット。Appを生成してこれらの認証情報を探す方法については、Microsoftのドキュメントを参照してください。Appを登録するには、以下の情報が必要になる場合があります。

  • Azureポータル：https://portal.azure.com/
  • **登録するSharePoint App：**SharePoint Online Rest API
  • DomoリダイレクトURL：https://oauth.domo.com/api/data/v1/oauth/providers/microsoft-onedrive-business/exchange

• Microsoft OneDrive for Businessコネクターには、次のAPI権限が必要です。

  • User.Read
  • Files.Read.All
  • offline_access

​

OneDriveのクライアントIDを取得するには：

1. https://portal.azure.comに移動します。
2. ［Microsoft Entra ID］（https://learn.microsoft.com/ja-jp/entra/fundamentals/new-name）**>［App registrations］**を選択します。
3. Web Appを見つけて、クリックします。
4. 「application ID」がクライアントIDです。

​

OneDriveのクライアントシークレットを取得するには：

1. https://portal.azure.comに移動します。
2. ［Microsoft Entra ID］（https://learn.microsoft.com/ja-jp/entra/fundamentals/new-name）>**［App registrations］**を選択します。
3. Web Appを見つけて、クリックします。
4. **［Certificates and secrets］**を開きます。
5. **［+New Value］**をクリックします。
6. 値の説明とシークレットの有効期限を入力します。**［Add］**をクリックします。
7. 新しい値が表示されます。［Value］フィールドをコピーして、Domoコネクターの［Value］フィールドに貼り付けます。

​

エンタープライズOAuth用Azure Appを作成する

Microsoft Azure Appを作成するには、以下の手順を実行します。

1. https://portal.azure.comにログインします。

2. **［App registrations］**をクリックします。

3. **［New registration］**をクリックします。

4. アプリケーション名を入力し、サポートされているアカウントのタイプを選択します。WebのリダイレクトURL（https://oauth.domo.com/api/data/v1/oauth/providers/microsoft-onedrive-business/exchange）を入力します。

   

5. **［Register］**をクリックします。

6. 次に、**［API Permissions］**をクリックします。

7. **［+Add Permissions］**ボタンをクリックします。

8. **［Microsoft Graph］>［Delegated Permissions］**を選択します。

9. 必要に応じて許可を選択してください。

10. 許可を追加した後、すべての設定済みの許可が以下のように一覧表示されます。

    

​

OneDrive for Businessアカウントに接続する

このセクションでは、Domoにアクセスするために必要なMicrosoftのアクセス許可設定を列挙するとともに、OneDrive for Businessコネクターページの**［認証情報］および［詳細］ペインのオプションについて説明します。このページのほかのペインの項目である［スケジュール設定］や［DataSetに名前を付け、説明を入力］**に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「コネクターを使用してDataSetを追加する」を参照してください。

​

［認証情報］ペイン

このペインには、OneDrive for Businessアカウントに接続する認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。

フィールド	説明
Client ID	OneDrive for BusinessクライアントIDを入力します。
Client Secret	OneDrive for Businessクライアントシークレットを入力します。

これらの認証情報を入力すると、Microsoftログイン画面が表示されます。ここに、Microsoftアカウントのユーザー名とパスワードを入力します。接続に成功したら、いつでも同じアカウントを使用して、新しいOneDrive for Business DataSetを作成できます。コネクターアカウントは、Data Centerの**［アカウント］**タブで管理できます。このタブの詳細については、「コネクターのユーザーアカウントを管理する」を参照してください。

​

［詳細］ペイン

このペインには、メインとなる**［Report］**メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。

メニュー	説明
Report	実行するOneDrive for Businessレポートを選択します。以下のレポートが利用できます。 Children 指定したフォルダまたはパスを持つアイテムの子を一覧表示します。 Default Drive 認証されたユーザーのOneDriveのデフォルトドライブに関するメタデータを返します。 Download Children Shared File 子フォルダのシェアされたファイルをDataSetとしてDomoにダウンロードします。その他の情報とともに、ファイルタイプおよびファイル/フォルダまたはパスを指定します。 Download File ファイルをDataSetとしてDomoにダウンロードします。その他の情報とともに、ファイルタイプおよびファイル/フォルダまたはパスを指定します。 Download Nested Children Shared File ネストされた子フォルダのシェアされたファイルをDataSetとしてDomoにダウンロードします。その他の情報とともに、ファイル名および完全なファイルパスを指定します。 Download Shared File シェアされたファイルをDataSetとしてDomoにダウンロードします。その他の情報とともに、ファイルタイプおよびファイル/フォルダまたはパスを指定します。 Drive By Id 選択したドライブIDのドライブを一覧表示します。 Drives 認証されたユーザーが利用可能なドライブを一覧表示します。 Properties 指定したファイル/フォルダまたはパスを持つアイテムのプロパティを返します。 Recent Items 認証されたユーザーが最近使用したアイテムのリストを返します。このリストには、ユーザーのドライブにあるアイテムと、ほかのドライブからアクセスできるアイテムが含まれます。 Shared Items 認証されたユーザーと共有されているアイテムを一覧表示します。
Addressing	アイテムのアドレス指定がIDベース（ファイルまたはフォルダ名を指定）か、パスベース（ファイルパスを指定）かを指定します。
Path	レポートを取得するファイルまたはフォルダの相対パスを入力します。例：/Documents/test.csv
File/Folder Name	取得するMS OneDriveファイル/フォルダの名前（または名前の一部）を拡張子なしで入力します。コネクターは、**［Date Field］**メニューで選択した内容にもとづき、名前が一致するものから、最後に作成または変更したファイルを返します。
Match Type	取得するファイルのファイル名が**［File Name］**で入力した名前から始まるのか、それともファイル名にその名前が含まれるのかを指定します。
Parent Folder/Parent Folder Name	完全なフォルダ名（大文字小文字の区別なし）を入力して、ファイル検索を特定フォルダのルートコンテンツに限定します。サブフォルダは無視されます。これを空白にすると、自分がアクセスできるすべてのフォルダのすべてのファイルが検索の対象になります。
Date Field	ファイルを作成日または最終変更日のどちらで取得するかを指定します。これは、**［File Name］**に入力した名前が複数のファイルに含まれている場合に便利です。
File Type	取得するデータファイルのファイルタイプを選択します。
Is Password Protected?	ファイルがパスワード保護されているかどうかを選択します。
Sheet Name	指定したスプレッドシート上の取得するシート名を入力します。
Sheet Name Match Type	シート名に対して実行する一致タイプを選択します。
File Name or Portion of File Name to Search For in ZIP	取得する圧縮ファイル名を入力します。空白のままにすると、最初の圧縮ファイルを取得します。
Zipped File Type	取得する圧縮データファイルのファイルタイプを選択します。
Drive ID	情報を取得するドライブを選択します。

​

よくある質問

このコネクターを使用するにはどのような認証情報が必要ですか？

OneDrive AppのクライアントIDとクライアントシークレットが必要です。

データはどれくらいの頻度で更新できますか？

DataSetの更新は、1時間に1回程度になるように設定してください。

注意すべきAPI制限はありますか？

Microsoftでは、APIの呼び出しはユーザー/Appごとに制限されています。レート制限を回避するには、同時に実行するようにスケジュール設定されているDataSetの数を減らします。