JReport Designer でJSON に連携するチャートとレポートを作成します。
CData JDBC Driver for JSON を使用すると、JSON がリレーショナルデータベースであるかのようにダッシュボードやレポートからライブデータにアクセスでき、使い慣れたSQL クエリを使用してJSON] をクエリできます。ここでは、JDBC データソースとしてJSON に連携し、JReport Designer でJSON のレポートを作成する方法を説明します。
JSON データに接続
- C:\JReport\Designer\bin\setenv.bat を編集し、JAR ファイルの場所をADDCLASSPATH 変数に追加します。
... set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\Program Files\CData\CData JDBC Driver for JSON 2016\lib\cdata.jdbc.json.jar; ...
- [File][New][Data Source]と進み、新しいデータソースを作成します。
- 表示されるダイアログで、データソースの名前(CData JDBC Driver for JSON) を作成し、JDBC を選択して[OK]をクリックします。
- [JDBC Connection Information]ダイアログで、JDBC ドライバーへの接続を構成します。
- Driver:[Driver]ボックスにチェックがついていることを確認し、ドライバーのクラスの名前を入力します。
cdata.jdbc.json.JSONDriver
- URL:jdbc:json: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続く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;
- User:認証に使用するユーザー名は、通常空白のままにします。
- Password:User と同様に認証に使用するパスワードも、通常は空白のままにします。
- Driver:[Driver]ボックスにチェックがついていることを確認し、ドライバーのクラスの名前を入力します。
[Add Table]ダイアログで、レポート(またはこのデータソースを使用する予定のレポート)に含めるテーブルを選択し、[Add]をクリックします。
ダイアログがテーブルのロードを完了したら、[Done]をクリックします。
- [Catalog Browser]では、レポートの作成に使用するクエリを作成できます。今すぐ、またはレポートの作成後に作成できますが、どちらにしても、 データソース(CData JDBC Driver for JSON) を展開()し、[Queries]を右クリックして[Add Query]を選択します。
- [Add Table/View/Query]ダイアログで、JDBC URL とTables を展開() し、クエリで使用するテーブルを選択して[OK]をクリックします。
- [Query Editor]ダイアログで、含めるカラムを選択するか、[SQL]ボタンをクリックして以下のようにカスタムクエリを手動で入力できます。
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]
クエリが作成されたら、[OK]をクリックして[Query Editor]ダイアログを閉じます。この時点で、JSON を新規または既存のレポートに追加する準備が整いました。
NOTE: クエリが作成されると、クエリに基づいて[Business View]を作成できます。[Business View]を使用すると、クエリに基づいてWeb レポートまたはライブラリコンポーネントを作成できます。これについてのより詳しい情報は、JReport のチュートリアルを参照してください。
レポートにJSON データを追加
JSON を使用してレポートを作成することができるようになりました。
- 新しいレポートを作成([File][New][Page Report]) するか、既存のレポートの[Chart Wizard]を開きます。
- クエリを選択(または上記を参照して新しいクエリを作成) します。
- クエリのカラムからグラフの[Category]と[Value]を割り当て、[Finish]をクリックします。
- レポートの[View]タブをクリックし、チャートを表示します。


