メインコンテンツへスキップ

​
はじめに

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に接続して情報を取得するには、次のものが必要です。

​
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］フィールドに貼り付けます。
    Secret.png

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

Microsoft Azure Appを作成するには、以下の手順を実行します。
  1. https://portal.azure.com にログインします。
  2. ［App registrations］ をクリックします。
    Capture1.PNG
  3. ［New registration］ をクリックします。
  4. アプリケーション名を入力し、サポートされているアカウントのタイプを選択します。WebのリダイレクトURL（ https://oauth.domo.com/api/data/v1/oauth/providers/microsoft-onedrive-business/exchange ）を入力します。
  5. ［Register］ をクリックします。
  6. 次に、［API Permissions］ をクリックします。
    API_permission.png
  7. ［+Add Permissions］ ボタンをクリックします。
    Capture8.PNG
  8. ［Microsoft Graph］>［Delegated Permissions］ を選択します。
  9. 必要に応じて許可を選択してください。
  10. 許可を追加した後、すべての設定済みの許可が以下のように一覧表示されます。
    Permissions modified.jpg

​
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回程度になるように設定してください。
Microsoftでは、APIの呼び出しはユーザー/Appごとに制限されています。レート制限を回避するには、同時に実行するようにスケジュール設定されているDataSetの数を減らします。