GeckoboardでHarvest のデータをダッシュボードに可視化

Geckoboard は、主要業績評価指標（KPI）のビジュアライゼーションを簡素化するビジネスインテリジェンスツールで、ライブダッシュボードを作成できます。Salesforce、Snowflake、Google Analytics、スプレッドシートなど、さまざまなソースからデータを統合し、視覚的に魅力的で理解しやすい形式で表示できます。シンプルさと明瞭さを重視して設計された Geckoboard は、企業がパフォーマンスをモニタリングし、目標を追跡し、データドリブンな意思決定を行うのに役立ちます。

CData Connect AI と組み合わせると、Geckoboard からダッシュボード、モニタリング、ビジュアライゼーションなどのためにHarvest のデータへ即座にクラウド間でアクセスできます。この記事では、Harvest に接続し、Geckoboard でHarvest のデータを使用してビジュアライゼーションを作成する方法を説明します。

CData Connect AI は、Harvest 向けのシームレスな SQL Server クラウド間インターフェースを提供し、Geckoboard でリアルタイムのHarvest のデータを使用したダッシュボードとビジュアライゼーションを簡単に作成できます。ビジュアライゼーションを構築する際、Geckoboard は必要なデータを取得するために SQL クエリを必要とします。最適化されたデータ処理を標準で備えており、サポートされているすべての SQL 操作（フィルターや JOIN など）を Harvest に直接プッシュし、サーバーサイド処理を活用してHarvest のデータを高速かつ効率的に取得します。

Geckoboard 用の Harvest 接続を設定

Geckoboard から Harvest への接続は、CData Connect AI によって実現されます。Geckoboard からHarvest のデータを扱うには、まず Harvest 接続を作成・設定します。

1. Connect AI にログインし、Sources をクリック、次に Add Connection をクリック

2. Add Connection パネルから「Harvest」を選択

3. Harvest に接続するために必要な認証プロパティを入力します。

   まず、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 を取得および更新する方法を管理できます。
   
4. Save & Test をクリック
5. Add Harvest Connection ページで Permissions タブに移動し、ユーザーベースの権限を更新します。

Personal Access Token を追加

REST API、OData API、または仮想 SQL Server 経由で Connect AI に接続する場合、Personal Access Token（PAT）が Connect AI への接続認証に使用されます。アクセスの粒度を維持するため、サービスごとに個別の PAT を作成することをお勧めします。

1. Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings ページを開きます。
2. Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック。
3. PAT に名前を付けて Create をクリック。
4. Personal Access Token は作成時にのみ表示されるので、必ずコピーして安全な場所に保存してください。

接続の設定と PAT の生成が完了したら、Geckoboard からHarvest のデータに接続する準備が整いました。

Geckoboard でリアルタイムの Harvest データに接続

以下の手順に従って、Geckoboard から CData Connect AI 仮想 SQL Server API への接続を確立します。

1. Geckoboard にログイン
2. カスタムダッシュボード名を追加し、Add widget をクリック
3. Connect your data 検索バーで「Databases」を検索
4. Database type として SQL Server を選択
5. 接続情報を入力：
   • Connection name：CData Connect AI への接続名を入力
   • Host：仮想 SQL Server エンドポイントを入力：tds.cdata.com
   • Port：14333 を入力
   • Database name：接続したい CData Connect AI データソースの Connection Name を入力（例：API1）
   • Username：CData Connect AI のユーザー名を入力。CData Connect AI インターフェースの右上に表示されています（例：[email protected]）
   • Password：Settings ページで生成した PAT を入力
   
6. Connect をクリック

接続の設定が完了したら、Harvest のデータ をクエリ・ビジュアライズできます。

Geckoboard でリアルタイムのHarvest のデータをビジュアライズ

Geckoboard でリアルタイムのHarvest のデータをビジュアライズするには、以下の手順に従ってください：

1. Paste your SQL query コンパイラ画面で、ビジュアライゼーションに必要な特定のHarvest のデータを選択する SQL クエリを記述

ユースケースに応じて、CData Connect AI の Playground または Query Builder 機能を使用して、必要な SQL クエリを生成することもできます


2. ビジネス要件に最適なビジュアライゼーションタイプ（折れ線グラフ、棒グラフ、または縦棒グラフ）を選択
3. 選択したチャートが Geckoboard に表示されます
4. グラフの右上にあるメニュー（3 つのドット）をクリックし、Edit を選択して SQL クエリを変更したり、チャートの更新間隔を設定したりできます

クラウドアプリケーションから Harvest データへのリアルタイムアクセス

これで、Geckoboard からリアルタイムのHarvest のデータへの直接のクラウド間接続が確立されました。ダッシュボードを作成して、データをシームレスにモニタリング・ビジュアライズできます。

Geckoboard などのクラウドアプリケーションから 100 以上の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスの詳細については、Connect AI ページをご覧ください。