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

CData JDBC Driver for Basecamp は、データドリブンな Java アプリケーションにBasecamp API への接続機能を統合します。CData JDBC Driver for Basecamp を 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 を入力します。

   Basecamp はBasic 認証もしくはOAuth 2.0 認証を使います。Basic 認証を使用するには、Basecamp へのログインに使用するuser およびpassword が必要です。OAuth 2.0 を使用して認証するには、Basecamp にアプリを登録してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。

   詳しくは、ヘルプドキュメントの「はじめに」セクションを参照してください。

   さらに、AccountId 接続プロパティを設定する必要があります。これはBasecamp にログイン後にURL で確認できます。

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

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

   java -jar cdata.jdbc.basecamp.jar
   

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

   

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

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

   jdbc:basecamp:[email protected];Password=test123;
   

7. 「Data Sets」フォルダを右クリックし、Basecamp用の JDBC データソースを選択します。
8. 表示されるダイアログで、レポート用のデータを取得する SELECT クエリを作成します。この記事では以下のクエリを使用します：

   SELECT Name, DocumentsCount FROM Projects
   

9. 「Palette」からエディターにチャートをドラッグします。チャートウィザードが表示されます。
10. チャートタイプを選択した後、「Select Data」タブでカラムをチャートフィールドにドラッグします。
11. 「Run」->「View Report」->「In Web Viewer」をクリックしてレポートを表示します。

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

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