はじめに
Microsoft OneDriveは、ビジネス用オンラインファイル共有とパーソナルクラウドコンテンツ管理サービスです。このコネクターを使用すると、指定したOneDriveフォルダにDomo DataSetからデータをエクスポートできます。OneDrive APIの詳細については、 https://msdn.microsoft.com/en-us/lib…/dn659752.aspx を参照してください。 OneDriveへのデータのエクスポートはData Centerで行います。このトピックでは、Microsoft OneDrive Writebackコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。必要条件
このコネクターを設定するには、次の情報が必要です。- Microsoft Azure Appのインストール。
- Domoデベロッパーアカウントに関連付けられたクライアントIDとクライアントシークレット
- Microsoft Azure Appに関連付けられているシークレットIDと値
DomoクライアントIDとクライアントシークレットを取得するには：
- Domoデベロッパーアカウント にログインします。
- 右上隅の ［My Account］ の下にある ［New Client］ をクリックします。
- アプリケーション名と説明を入力します。
- ［Data］ と ［User］ のチェックボックスを選択して、アプリケーションのスコープを指定します。
- ［Create］ をクリックします。クライアントを作成したら、 ［Manage Client］ をクリックしてそのクライアントを管理できます。
- ［Client Secret］ が ［Manage Client］ セクションに表示されます。
シークレット（クライアント）IDを取得するには：
- https://portal.azure.com にアクセスします。
- ［Azure Active Directory］>［App registrations］ を選択します。
- Web Appを見つけ、クリックします。
- 「application ID」が クライアントID です。
シークレットの値を取得するには：
- https://portal.azure.com にアクセスします。
- ［Azure Active Directory］>［App registrations］ を選択します。
- Web Appを見つけ、クリックします。
- ［Certificates and secrets］ を開きます。
- ［+New client secret］ をクリックします。
- クライアントシークレットの説明とシークレットの有効期限を入力します。［Add］ をクリックします。
- 新しいクライアントシークレットが表示されます。それをコピーして、Domoコネクターの［Client Secret］フィールドに貼り付けます。
Microsoftのアクセス許可
Microsoftで正しいアクセス許可を持っていると、Microsoft OneDrive Writebackコネクターを使用して効果的にデータにアクセスできます。新しいAppのアクセス許可を設定する
これらの手順は、新しいAppにのみ関係します。- https://apps.dev.microsoft.com/ に移動してサインインします。
-
［Add an app］ をクリックします。
- Appに名前を付けます。
-
［Create］ をクリックします。
表示されるApp IDがクライアントIDです。
-
［Generate new password］ をクリックします。
今後再び表示されることはないため、この情報は保存しておいてください。これがシークレットです。
- ［OK］ をクリックします。
- ［Add platform］ をクリックします。
- ［Web］ を選択します。
-
［Redirect URLs］ フィールドに、URL https://oauth.domo.com/api/data/v1/oauth/providers/domo-to-onedrive/exchange を入力します。
- ［Save］ をクリックします。
-
Files.Read.All、offline_access、およびSites.ReadWrite.Allの権限を追加します。
- ［Save］ をクリックします。
- ［Manage］ の下で ［Certificates & Secrets］ を選択します。証明書は、トークンを要求するときにアプリケーションの識別情報を証明するためのシークレットとして使用できます。これは、パブリックキーと呼ばれることもあります。
- ［+New client secret］ ボタンを選択します。
-
［Description］ に値を入力し、［Expires］に適したオプションを選択し、［Add］ をクリックします。
- Domoコネクターに移動してクライアントIDとシークレットを使って接続します。
接続を設定する
このセクションでは、Microsoft OneDrive Writebackコネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
このペインには、Domoデベロッパーアカウントに接続するための認証情報の入力フィールドがあります。下表では、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
OneDrive App Client ID | 登録したOneDrive Appに関連付けられているクライアントIDを入力します。 |
OneDrive App Client Secret | 登録したOneDrive Appに関連付けられているクライアントシークレットを入力します。 |
Domo Client ID | Domoデベロッパーアカウントに関連付けられたクライアントID |
Domo Client Secret | Domoデベロッパーアカウントに関連付けられたクライアントシークレット |
［詳細］ペイン
このペインには、データを指定してデータの送信先を示すための多数のフィールドがあります。メニュー | 説明 |
|---|---|
Input DataSet ID | OneDriveフォルダまたはワークスペースにコピーするDataSetのDataSet ID（GUID）を入力します。Data CenterでDataSetの詳細ビューを開き、URLの datasources/ に続く部分を見ると、IDを見つけることができます。 例えば、URLが https://mycompany.domo.com/datasources/845305d8-da3d-4107-a9d6-13ef3f86d4a4/details/overview であれば、DataSet IDは 845305d8-da3d-4107-a9d6-13ef3f86d4a4 になります。 |
Enter Folder Path | データを書き戻すフォルダのパス（大文字小文字の区別なし）を入力してください。空欄の場合、データはルートフォルダに書き戻されます。 例： Test/Test1/Test2/ の場合、データはOneDriveのTest2フォルダに書き戻されます。 |
Select Filename | データのコピー元となるファイルの指定方法を選択します。
|
Filename | 出力するファイル名を入力します。 現在の日付をファイル名に追加するには、マクロ<current_date>か<current_date-1>を使用します。例：ファイル名が domo_current_date の場合。OneDriveに生成される出力ファイルは、domo_2019-07-16のように、domo_（yyy-mm-dd形式の今日の日付）になります。 |
Select File Encoding | OneDriveに書き戻すファイルのエンコーディングを選択します。エンコーディングが選択されない場合、ファイルはUTF-8エンコーディングで書き戻されます。 |