Dundas BI でHarvest のデータを使ってダッシュボードを構築
CData のHarvest 用 ODBC ドライバーは、ODBC 標準経由でHarvest のリアルタイムデータにアクセスし、使い慣れた SQL クエリで各種 BI、レポート、ETL ツールからHarvest のデータを利用可能にします。この記事では、汎用 ODBC データプロバイダーとしてHarvest に接続し、Dundas BI でHarvest のデータを基にしたチャート、レポート、ダッシュボードを作成する方法を解説します。
Harvest のデータへの接続設定
- まだ設定していない場合は、データソース名(DSN)で必要な接続プロパティを指定します。DSN の設定は組み込みの Microsoft ODBC データソースアドミニストレーターを使用して行えます。これはドライバーインストールの最終ステップでもあります。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 接続プロパティも設定することをお勧めします。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時にパフォーマンスを向上させるのに役立ちます。
- Dundas BI インターフェースを開き、メニューから New Data Connector をクリックします。

- Dundas BI の Data Connector を設定します:
- Data Connector の名前を入力します。
- Data Provider として「ODBC generic」を選択します。
- 「Use System DSN」チェックボックスをオンにします。
- 適切なシステム DSN を選択します。

Harvest のデータをダッシュボードに追加
これでHarvest のデータを使ってダッシュボードを作成する準備が整いました。
- ホームページに移動します。
- Explore Data をクリックします。
- 適切な Data Connector を展開します。
- Connector から関連するデータをパネルにドラッグします。
- 「テーブル」全体を選択して追加することもできますが、適切なビジュアライゼーションを作成するには Metric Set からメジャーや行を削除する必要があるかもしれません。あるいは、ビジュアライゼーションに含めたいフィールドのみを選択することもできます。
- フィールドを選択した状態で、メジャーと行にフィルタや条件を追加し、ビジュアライゼーションをさらにカスタマイズできます。
- メニューバーから Re-visualize をクリックし、データに適したビジュアライゼーションを選択します。
- Add To New Dashboard をクリックして、ビジュアライゼーションを新しいダッシュボードに追加します。
- Harvest のデータを使ったダイナミックなビジュアライゼーションを作成してダッシュボードを設定します。