はじめに

このページではMicrosoft ExcelをCxense APIとともに利用する方法をいくつかご紹介します。例えば：

•  辞書管理ツールとして -- Cxenseプラットフォームはお客様固有の辞書を用いてカスタマイズ（カスタムタクソノミーの適用や検索機能の補完）できますが、これらの辞書はExcelワークブックを用いてアップロードします。アップロードするためのAPIについては例えばこちらで説明しています。

• APIを使用するための「GUI」として -- Cxenseプラットフォームから取得したデータはExcelでテーブルとして扱うことができます。これによりデータをさらに加工したり（例えばフィルタを掛けたり、他のテーブルと合わせて分析するなど）グラフ化することが可能です。この方法について説明するのがこのページの主な目的です。

Power Query

Cxense APIからMicrosoft Excelにデータをインポートするには、以下の手順を実施します：

1. Power QueryのExcel用アドインをダウンロードしてインストールします。

2. ExcelへインポートするためのPersistedリクエストを作成します。Persistedリクエストを使用するのは、Power QueryアドインがAPI経由でデータを取得する際に認証を回避するためです。Persistedリクエストを作成するには以下の２つの方法があります：

   1. /persisted/create APIを使用する

   2. admin.cxense.comのGUI上の"API"タブを使用する

3. Persistedリクエストを作成すると、/persisted/execute APIで使用するIDが得られます。以下の手順ではこのIDがabc123であるとして記載します。

4. ExcelのPower Queryアドインのメニューにおいて"From Web"を選択します。

5.  表示されたダイアログ上で、PersistedリクエストのURL https://api.cxense.com/persisted/execute?persisted=abc123 (abc123を実際のIDに置き換えてください) を入力します。Persistedリクエストをパラメータ可変で作成した場合にはURLにそのパラメータも加えてください。

6. "OK"ボタンをクリックしてインポートウィザードにしたがってAPIのJSON応答をどのようにテーブルに配置するかを設定します。

CSV

もう一つのオプションはCxense APIから取得したデータをCSVファイルにエクスポートすることです。Cxense APIはJSON形式でデータを返しますが、jq のようなツールでCSVフォーマットに変換することができます。