Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

dRofus supports use of Power Query that enables users to seamlessly import, update and re-shape data from within Excel, PowerBI and other Microsoft products. Use of Power Query can e.g. reduce the need to upload Excel templates to dRofus as you will now be able to update your Excel spreadsheet directly from Excel.

...

dRofusは、Excel、PowerBI、その他のMicrosoft製品からデータをシームレスにインポート、更新、再形成できるパワークエリの使用をサポートしています。
例えば、パワークエリを使用することで、Excelスプレッドシートを、Excelから直接更新することができるため、ExcelテンプレートをdRofusにアップロードする必要性を、
減らすことができます。

Info

パワークエリは、様々なマイクロソフト製品から利用することができます。このページでは、Excelでの使い方に焦点を当てます。
詳しいパワークエリについては、こちらをご覧ください; https://docs.microsoft.com/en-us/power-query/

Not all Built in Excel exports supports Power Query. Currently following exports are supported;

  • Items

  • Occurrences

  • Room Templates

  • Room Function

  • Rooms

  • Products

  • Users

You can see a Power Query icon in the top right corner for the exports that are supported.

Setting up Power Query between dRofus and Excel

There are a few steps you need to do to create an Excel you can update;

  1. Create a query in dRofus to use in Excel

  2. Open Excel and insert Query created by dRofus

  3. Credentials/Login

1. Create a query in dRofus to use in Excel

In this example, we will use the export Rooms to create our export. Click on the Rooms export and select which fields you want to include in your export. In the image beneath we have included a mix of Room Core and Room Data fields.

Note: If using filters, when available, Is Empty is a supported selection.

Then select PowerQuery in the top right corner of the export detail window.

...

When you select Power Query, a new dialogue will open with all necessary information for creating our Excel export.

...

  1. The query we are going to use to import/update data from dRofus to Excel. The query will change based on which fields you have included in the export. The Power query will also include details about server, database and project ID.

  2. API request URI - to use in other applications that do not support PowerQuery. It will change based on which fields you have included in the export.

    • Selecting the Is Empty option on a field's filter will display here as eq null.

  3. API Key is used for authentication in Excel

2. Open Excel and insert Query created by dRofus

In Excel go to Data → Get & Transform Data → Get Data →  From other sources → Blank Query:

...

You will now open the Power Query Editor. Go to Home → Query → Advanced Editor and remove all content in the query;

...

Now we are going to copy the query created by dRofus and paste it into the blank query. Select all text in the Power Query field in dRofus and paste it into the blank query in Excel and press Done

...

After the query has been processed you will see the columns have been set up in Excel. Chose Close and Load to load the data into your Excel spreadsheet.

...

3. Credentials/Login

The first time you connect to a data-source from Excel you will be asked how to connect and insert your credentials;

...

Select Edit Credentials and select Basic. Insert your credentials as the example below 

...

  1. For username, please use: apikey

  2. For password, copy the API key from dRofus' PowerQuery window as shown below

    Image Removed

...

すべての組み込みExcelエクスポートが、パワークエリをサポートしているわけではありません。現時点では、以下のエクスポートがサポートされています;

  • アイテム

  • オカレンス

  • 部屋テンプレート

  • 部屋機能

  • 部屋

  • 製品

  • ユーザー

サポート対象のエクスポートには、右上にパワークエリのアイコンが表示されます。

dRofusとExcel間のパワークエリの設定

更新可能なExcelを作成するには、いくつかのステップが必要です;

  1. dRofusでクエリを作成してExcelで使用。

  2. Excelを開き、dRofusが作成したクエリを挿入。

  3. 認証情報/ログイン。

1. dRofusでクエリを作成してExcelで使用する

この例では、エクスポートの作成に、エクスポート・部屋を使用します。部屋のエクスポートをクリックし、エクスポートに含めるフィールドを選択します。
下の画像には、部屋コアと部屋データ・フィールドが混在しています。

:フィルタを使用する場合、使用可能な場合は、Is Emptyがサポートされている選択です。

次に、エクスポートの詳細ウィンドウの右上にある、パワークエリを選択します。

...

パワークエリを選択すると、新しいダイアログが開き、Excelエクスポートに必要な情報が表示されます。

...

  1. dRofusからExcelにデータをインポート/更新するために使用するクエリです。クエリは、エクスポートにどのフィールドを含めるかによって変わります。
    また、パワークエリには、サーバー、データベース、プロジェクトIDの詳細も含まれます。

  2. APIリクエストURI - パワークエリをサポートしていない他のアプリケーションで使用します。どのフィールドがエクスポートに含まれているかによって変わります。

    • フィールドのフィルタで、Is Emptyオプションを選択すると、ここはeq nullと表示されます。

  3. APIキーはExcelの認証に使用します。

2. Excelを開き、dRofusが作成したクエリを挿入する。

Excelのデータ → データの取得と変換 (Get & Transform Data)→ データの取得 (Get Data)→ 他のソースから (From other sources)→ 空白のクエリ (Blank Query)

...

次に、パワークエリエディタを開きます。Home (ホーム) → Query (クエリ)→ Advanced Editor (アドバンスエディタ )と進み、クエリ内のすべての内容を削除します;

...

次に、dRofusが作成したクエリをコピーし、空白のクエリに貼り付けます。dRofusのパワークエリのフィールドにある全てのテキストを選択し、
Excelの空白のクエリに貼り付け、完了を押します。

...

クエリが処理されると、Excelに列が設定されていることがわかります。データを、Excelスプレッドシートに読み込むには、”Close and Load (閉じて読み込む) ”を選択します。

...

3. 認証情報/ログイン

Excelからデータソースに初めて接続する場合、接続方法と認証情報の入力が必要になります;

...

Edit Credentials (認証情報の編集)を選択し、Basic (ベーシック)を選択します。以下の例のように、認証情報 (credentials)を入力します。

...

  1. ユーザー名については、こちらをご利用ください:apikey

  2. パスワードは、dRofusのパワークエリのウィンドウからAPIキーをコピーします。

    Image Added

Info

他のユーザがスプレッドシートにアクセスして、データを更新する場合は、 上記の手順で示したように、API キーで認証する必要があります。