グラフ

グラフの表示に使うデータはレポートが生成される時に集中されデータセットに保存されます。JasperReportsでは次のデータセットに対応しています：

• 円
• カテゴリ
• 期間
• 時系列
• XY
• XYZ
• 高い低い
• 値

レポートには、レポートで使うメインデータセットがあります。しかし、グラフによってメインデータセットに含まれていないデータが必要な場合もあります。このような場合はサブデータセットを定義します。各データセット及びサブデータセットは単独で定義され、データセット間の関係は持ちません。

グラフを作成する前にグラフで使うデータセットを定義しましょう。

1. アウトライン・ビューからレポートを右クリックして、「データセットの作成」を選択します。
   データセット作成ウィザードが開きます。
   
2. データセットの名前を変更します。ここでは「sample_dataset」に変えます。
3. 「接続またはデータソースから新しいデータセットを作成」を選択して、「次へ >」ボタンを押下します。
   「データセット」ウィンドウが開きます。
   
4. データアダプタは「Sample DB」を選択します。
5. クエリー文には「SELECT COUNT(*) AS orders, shipcountry FROM orders GROUP BY shipcountry」を入力します。
   「次へ >」ボタンを押下します。
   「フィールド」ウィンドウが開きます。
6. 「データセットフィールド」の内容をすべて「フィールド」へ移動します。
   データセットフィールドのフィールドをすべて選択して「>」ボタンを押下します。
   
7. 「Group By」ウィンドウが表示します。「次へ >」ボタンを押下します。
8. 「完了」ボタンを押下します。
   

さて、早速グラフを作成して見ましょう！次の手順で3次元の円グラフを作成することができます。

1. 新しいレポートを作成します。データソースには「sample_dataset」を選択します。
2. 国別の注文数を表示する円グラフを作成します。そのために、次のSQL文を入力します：
   SELECT COUNT(*) AS orders, shipcountry FROM orders GROUP BY shipcountry
3. 作成されたフィールドを詳細領域にコピーします。
   アウトライン・ビューからフィールドを展開して、ordersとshipcountryを詳細領域にドラッグ＆ドロップします。
   
4. サマリー領域の高さを378pxに設定します。
   
5. パレット・ビューから「グラフ」コンポーネントをレポートレイアウトのサマリー領域にドラッグ＆ドロップします。
   グラフウィザードが開きます。
   
6. 3次元円グラフを選択して「次へ >」ボタンを押下します。
7. サマリー領域に配置された大きさを領域の大きさまで拡大します。
   

1. グラフコンポーネントを選択します。グラフデータ設定ウィンドウが開きます。
   このウィンドウからグラフで使うデータを設定します。
   
2. 表示するスライスを制限する場合は、「表示する最大数」を設定します。指定した数以上のデータは「その他」に纏められます。このチュートリアルでは「10」に設定してくだしあ。
3. このグラフ内のみでのデータセット指定する場合は、「データセット」タブ内の項目を設定します。「インクリメント」と「リセット」の設定はレポートのプロパティ設定と同じ動作を行います。
   
4. グラフで使うデータもこのグラフデータ設定ウィンドウで指定します。円グラフでは次の3つの項目を設定します：
   • キー：円グラフのスライスを特定できる識別子。キーが重複していると前のキーが上書きされます。なお、キーがnullの場合はエラーになります。
   • ：キーに関連した値
   • ：スライス用のラベル。デフォルトはキーです。
   各項目の右にあるボタンをクリックすると入力ダイアログが表示します。チュートリアル用にダイアログからは以下のデータを入力してください：
   値：$F{orders}
   ラベル：$F{shipcountry}
   キー：$F{shipcountry}
5. 「完了」ボタンを押下します。
6. レポートを保存して、プレビューしてください。
   
   円グラフの各スライスはその国の合計注文数です。

グラフの外観はプロパティ・ビューから設定します。グラフコンポーネント用のプロパティ・ビューには次のタブがあります：
外観、枠、ハイパーリンク、グラフ、グラフプロット、詳細
詳細タブはグラフのすべてのプロパティを表示します。

JasperReportsはグラフを処理するのに、JFreeChartを使っています。残念ながらJFreeChartが提供しているすべての機能はプロパティから設定できません。但し、JasperReportsで未対応の機能は次のJavaインターフェースを実装して使うことができます：
net.sf.jasperreports.engine.JRChartCustomer
このクラスには次の1つのメソッドのみが定義されています。
public void customize(JFreeChart chart, JRChart jasperChart); このメソッドをオーバーライドして使いかい機能を実装することができます。このメソッドの引数はJFreeChartオブジェクトとJRChartオブジェクトです。JFreeChartオブジェクトはJFreeChartのオブジェクトです。JRChartオブジェクトはJasperReportsのグラフオブジェクトです。指定したデータセット情報などの情報はJRChartにあります。

レーダーチャートは別のコンポーネントとして開発されたため、他グラフとは別のコンポーネントになっていますが設定方法は同じです。

1. 新しいレポートを作成します。データソースには「sample_dataset」を選択します。
   クエリーは次のようにします：
   SELECT * FROM orders
   「次へ >」ボタンを押下します。
2. すべての項目を使うので、選択してフィールドへ移動します。
   「次は >」ボタンを押下します。
3. グループは行わないので、「次へ >」ボタンを押下します。
4. アウトライン・ビューから「題名」領域と「サマリー」領域以外の領域をすべて削除します。
5. 固定文字列を題名領域に配置します。文字列を「従業員別の月間／国別の注文数」とします。
6. さまりー領域の高さを350ピクセルにします。

1. パレットビューからレーダーチャートコンポーネントをレポートレイアウトにドラッグ＆ドロップします。
   
2. アウトライン・ビューからレポートを右クリックしてデータセットを新規に作成します。
3. 新規に作成したデータセットをクリックして、プロパティ・ビューのフィルタに次の定義を入力します。
   
   「フィルタ」タブを選択した次の式を入力します。（改行は入れないでください。)
   ( $F{shipcountry}.startsWith("N") || $F{shipcountry}.startsWith("M") || $F{shipcountry}.startsWith ("U") || $F{shipcountry}.startsWith ("I") ) || $F{shipcountry}.startsWith("A") && ( $F{shipname}.startsWith( "M" ) || $F{shipname}.startsWith( "A" ) || $F{shipname}.startsWith( "G" ) )
   
4. 入力した後に「OK」ボタンを押下します。
5. レーダーチャートをダブルクリックします。「グラフデータ設定」ウィンドウが開きます。
6. 「シリーズ」ボタンを押下します。「＄F{employeeid}」を入力します。
7. 「値」ボタンを押下します。「MONTH(%F{orderdate}))」を入力します。
8. 「カテゴリ」ボタンを押下します。「$F{shipcountry}」を入力します。
9. 「完了」ボタンを押下します。

1. レーダーチャートをクリックします。
2. プロパティ・ビューの「凡例」の「凡例を表示」を「True」に設定します。
3. 「位置」ドロップダウンを使って凡例を左へ移動させます。
4. パレット・ビューから固定文字列コンポーネントを凡例の上に配置します。
   内容を「従業員番号」にします。
5. レポートを保存します。
   
6. レポートをプレビューします。