BIRT でKlipfolio のデータのレポートを作成

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
組み込み分析にリアルタイムKlipfolio のデータを提供。

CData JDBC Driver for Klipfolio は、データドリブンな Java アプリケーションにKlipfolio API への接続機能を統合します。CData JDBC Driver for Klipfolio を BIRT(Business Intelligence Reporting Tools)プラットフォームと組み合わせることで、データの変更をリアルタイムに反映する BIRT レポートを作成できます。

  1. まだインストールしていない場合は、BIRT Framework プラグインと Database Development プラグインを Eclipse にインストールします。
  2. 「File」->「New」->「Report」をクリックします。Report Design パースペクティブが開きます。
  3. Data Explorer で「Data Sources」を右クリックし、「New Data Source」をクリックします。
  4. 「Create from a Data Source Type in the Following List」オプションを選択し、「JDBC Data Source」を選択します。
  5. 「Manage Drivers」をクリックし、インストールフォルダの lib サブフォルダにあるドライバー JAR を追加します。
  6. 「Database URL」ボックスに、接続文字列を含む JDBC URL を入力します。

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

    Klipfolio API プロファイル設定

    Klipfolio に認証するには、API Key を提供する必要があります。API Key は、Klipfolio Dashboard アプリのMy Profile ページから、または管理者の場合はUsers から生成できます(user.manage 権限が必要です)。ProfileSettings プロパティにAPI Key を設定して接続します。

    組み込みの接続文字列デザイナー

    JDBC URL の構築には、Klipfolio JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

    java -jar cdata.jdbc.api.jar
    

    接続プロパティを入力し、接続文字列をクリップボードにコピーします。

    JDBC URL を設定する際、Max Rows 接続プロパティも設定しておくと良いでしょう。返される行数が制限されるため、レポートやビジュアライゼーションの設計時のパフォーマンスが向上します。

    一般的な JDBC URL は以下のとおりです:

    jdbc:api:Profile=C:\profiles\Klipfolio.apip;ProfileSettings='APIKey=your_api_key';
    
  7. 「Data Sets」フォルダを右クリックし、Klipfolio用の JDBC データソースを選択します。
  8. 表示されるダイアログで、レポート用のデータを取得する SELECT クエリを作成します。この記事では以下のクエリを使用します:
    SELECT Id, Name FROM DataSources WHERE IsDynamic = 'true'
    
  9. 「Palette」からエディターにチャートをドラッグします。チャートウィザードが表示されます。
  10. チャートタイプを選択した後、「Select Data」タブでカラムをチャートフィールドにドラッグします。
  11. 「Run」->「View Report」->「In Web Viewer」をクリックしてレポートを表示します。

これで、BIRT レポートがKlipfolio のデータの更新を反映できるようになりました。

レポートをアプリケーションサーバーに公開するには、ドライバー JAR を BIRT Viewer のクラスパスに追加します。詳細については、Java アプリケーションサーバーへの JDBC ドライバのデプロイに関する CData KB ガイドを参照してください。

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

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

Klipfolio に接続 お問い合わせ