BIRT Reports をJSON データ でデザイン

CData JDBC Driver for JSON は、JSON APIs への接続をデータドリブンJava アプリケーションに統合します。CData JDBC Driver for JSON をBIRT (Business Intelligence Reporting Tools) のプラットホームで使用することで、リアルタイムでデータの変更を反映するBIRT レポートを作成できます。

1. Eclipse 用のBIRT Framework プラグインとDatabase Development プラグインをインストールします。
2. ［File］->［New］->［Report］と進みます。［Report Design perspective］が表示されます。
3. ［Data Explorer］で［Data Sources］を右クリックし、［New Data Source］をクリックします。
4. ［Following List］オプションから［Create from Data Source Type］を選択し、［JDBC Data Source］を選択します。
5. ［Manage Drivers］をクリックし、インストールフォルダのlib サブフォルダにあるドライバーのJAR を追加します。
6. ［Database URL］ボックスに、接続文字列を含む［JDBC URL］を入力します。

   データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。本製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー（ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー）としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。

   URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。

   DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。

   • Document（デフォルト）：JSON データのトップレベルのドキュメントビューをモデル化します。本製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
   • FlattenedDocuments：ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
   • Relational：階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。

   リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。

   ビルトイン接続文字列デザイナ

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

   java -jar cdata.jdbc.json.jar

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

   

   JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

   以下は一般的なJDBC URL です。

   jdbc:json:URI=C:\people.json;DataModel=Relational;
7. ［Data Sets］フォルダを右クリックし、［JDBC data source for JSON］を選択します。
8. 表示されるダイアログで、レポートのデータを取得するために使用するSELECT クエリを構築します。この記事では、以下のクエリを用います。 SELECT [people].[personal.age] AS age, [people].[personal.gender] AS gender, [people].[personal.name.first] AS first_name, [people].[personal.name.last] AS last_name, [vehicles].[model], FROM [people] JOIN [vehicles] ON [people].[_id] = [vehicles].[people_id]
9. ［Palette］で、［Chart］をエディタにドラッグします。［Chart］ウィザードが表示されます。
10. チャートタイプを選択した後、［Select Data］タブのチャートフィールドにカラムをドラッグします。
11. ［Run］->［View Report］->［In Web Viewer］とクリックして、レポートを表示します。

これによって、BIRT レポートがJSON の更新をすべて取得できるようになります。

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