Clear Analytics でHarvest のデータを使ってチャートを作成

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Clear Analytics でHarvest のデータ を基にした動的なチャートを作成し、分析を実行。

CData ODBC ドライバー for Harvest は、ODBC 標準を介してHarvest のライブデータへのアクセスを可能にし、さまざまな BI、レポート、ETL ツールでHarvest のデータ を直接扱うことができます。この記事では、Microsoft Excel のアドインである Clear Analytics を使って、Harvest に ODBC データソースとして接続し、Harvest のデータ を基にしたクエリ、テーブル、チャート（PivotTable を含む）を作成する方法を説明します。

Harvest のデータに接続


ODBC データソース名の設定

まだ設定していない場合は、データソース名（DSN）で必要な接続プロパティを指定します。Microsoft ODBC データソースアドミニストレーターを使って DSN を作成・設定できます。これはドライバーインストールの最終ステップでも可能です。Microsoft ODBC データソースアドミニストレーターを使った DSN の作成と設定方法については、ヘルプドキュメントの「はじめに」を参照してください。

まず、Profile 接続プロパティをディスク上のHarvest プロファイルの場所に設定します（例：C:\profiles\Harvest.apip）。次に、ProfileSettings 接続プロパティをHarvest の接続文字列に設定します（以下を参照）。

Harvest API プロファイル設定

Harvest に認証するには、トークン認証またはOAuth 標準のいずれかを使用できます。自分のデータに接続するにはBasic 認証を使用します。他のユーザーが自分のデータに接続できるようにするにはOAuth を使用します。

トークン認証の使用

トークン認証を使用するには、ProfileSettings 接続プロパティでAPIKey にHarvest パーソナルアクセストークンを設定します。APIKey に加えて、ProfileSettings でAccountId を設定して接続します。

OAuth 認証の使用

まず、Harvest でOAuth2 アプリケーションを登録します。アプリケーションはHarvest ID の「Developers」セクションから作成できます。

以下の接続プロパティを設定すると、接続できるようになります。

  • ProfileSettings：ProfileSettings でAccountId を設定します。
  • AuthScheme：OAuth に設定します。
  • OAuthClientId：アプリ設定で指定したclient ID に設定します。
  • OAuthClientSecret：アプリ設定で指定したclient secret に設定します。
  • CallbackURL：アプリ設定で指定したRedirect URI に設定します。
  • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、ドライバーがOAuthAccessToken を取得および更新する方法を管理できます。

DSN を設定する際、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションを作成する際のパフォーマンス向上に役立ちます。

Clear Analytics でデータソースを設定

  1. Excel を開き、CLEAR ANALYTICS リボンに移動します。Data Manager を開きます。
  2. データソースとして Database を選択します。
  3. Set Connection セクションで、新しいデータベースを作成するオプションをクリックします。
  4. データソースとして Microsoft ODBC Data Source を選択し、OK をクリックします。
  5. ドロップダウンメニューから、先ほど設定した DSN を選択します。
  6. Set Connection セクションに戻り、SQL Builder Provider として Standard (ANSI ODBC) Query Builder を選択して Next をクリックします。
  7. Schema/Owner を選択し、Clear Analytics で使用するドメイン（テーブル）を選択します。
  8. 必要に応じて、テーブルやカラムの表示名と説明をカスタマイズしてデータオブジェクトを準備します。
  9. CData ODBC ドライバーの大半では、ドメインにキー日付を設定する必要はありません。
  10. Domain Relations セクションで、テーブル間のリレーション情報を追加します。
  11. Domain Tree セクションで、データのグループを作成し、利用可能な項目をグループに追加します。
  12. データのサマリーを確認し、Finish をクリックします。

Harvest のデータでチャートを作成

これでHarvest のデータ を使ったチャートを作成する準備ができました。

新規クエリの作成

  1. CLEAR ANALYTICS リボンの Repository をクリックします。
  2. 新しいクエリを作成します。
  3. 取得するカラムを選択します。
  4. データの集計タイプを設定します（データを集計しない場合は空白のエントリを使用します）。
  5. カラムを下のウィンドウにドラッグして、フィルタと数式を設定します。
  6. クエリに名前を付けて Save をクリックします。

クエリレポートに基づいてチャートを作成

クエリを作成したら、レポートを実行してチャートを表示する準備ができました。
  1. CLEAR ANALYTICS リボンの Report Explorer をクリックします。
  2. Report Explorer ペインで、ツールバーの「New Report」アイコンをクリックします。
  3. 先ほど作成したクエリを選択します。
  4. レポートに名前を付けて「Save and Execute」をクリックします。
  5. Report Explorer 内の Results タブをクリックします。
  6. レポートを展開し、チャートを Excel スプレッドシートにドラッグします。
  7. 表示される PivotChart ウィンドウで、フィールド（カラム）を Filters、Legends、Axis (Categories)、Values ウィンドウにドラッグします。

Clear Analytics で新しいデータソースを確立し、チャートを作成したら、Harvest のデータ の分析を始める準備ができました。ODBC Driver for Harvest と Clear Analytics を使用すると、Harvest からのライブデータを使って Excel でセルフサービス分析を実行できます。

はじめる準備はできましたか？

API Driver で Harvest のライブデータに接続

Harvest に接続 お問い合わせ

この記事の内容

関連記事