Embed Size (px)
Citation preview
1
2
本チュートリアルではこのようなPDF形式のレポートを作成します。
3
4
5
アウトラインタブプロジェクトタブの隣に移動することで、各タブの内容領域を大きくします。
6
画面の右側に表示されるPaletteタブも同じように問題タブの右に移動します。
7
アウトライン・ビューとPaletteビューを移動した後のJaspersoft Studio画面です。
8
9
10
11
12
レポートを作成する場合は、先ずレポートレイアウトを作成します。 アイコンバーから「新規レポート」アイコンを選択します。
13
レポート用の用紙を選択します。 ①今回は「空白 A4」を選択します。
②用紙を選択した後に次へ」ボタンを押下して次ぎのウィザード・ページに移動します。 JasperReportsは自由な用紙サイズを指定することができます。用紙選択ウィザード
ページで表示されていない用紙を使う場合はウィザードを終了した後に用紙を変更します。
14
①レポートを保存するフォルダを指定します。フォルダはJaspersoft Studioが起動する時に指定したワークスペース内に作成されます。 ②レポートレイアウトのファイル名を指定します。
③レポートレイアウトファイルの保存先情報を指定した後に、「次へ」ボタンを押下して次ぎのウィザード・ページに移動します。
15
レポートに記入するために使うデータを指定します。 ①使うデータベースの定義を新規に設定するため、「新規」ボタンを押下します。
16
①チュートリアルではMySQLデータベースのデータを使うため、「JDBCデータベース接続」を選択します。 ②「次へ」ボタンを押下して次ぎのウィザード・ページに移動します。 JasperReports ServerはJaspersoft Studioで対応しているすべてのデータアダプタ用のデータソースがありません。レポートをJasperReports Serverに登録する場合は事前に対応しているデータソースがあるか確認することを推奨します。
17
18
19
このページからは、データベース接続の情報を設定します。 ①データベース情報を識別するための名前を入力します。 ②「JDBCドライバ」には使うJDBCクラス名を入力します。右の▼ボタンをクリックして一覧から選択します。一覧に表示されない場合は直接クラス名を入力してください。 ③データベースに接続するための情報を入力します。 Jaspersoft StudioにはTibco Jaspersoft版のJDBCドライバも同梱されていますが、データベースベンダからのJDBCドライバと100%互換性はないため、場合によっては結果が異なることがあるので注意してください。
20
Jaspersoft StudioにMySQL JDBCドライバは同梱されていないので、インストールする必要があります。 ①JDBCドライバのjarファイルを指定するために、「ドライバクラスパス」タブを選択します。 ②「追加」ボタンを押下して、MySQL JDBCドライバのjarファイルを選択します。
21
①指定したjarファイルが正常に登録されるとパスとファイル名が表示されます。 ②JDBC jarファイルが正常に登録されたことを確認した後に、データベースに接続できるか確認するため、「テスト」ボタンを押下します。
22
①データベースに正常に接続された場合は「成功」を表示されます。 ②「OK」ボタンを押下して接続テスト・ダイアログを閉じます。接続結果がエラーの場合は「データベース接続情報」タブを選択して、接続情報を修正してください。
23
これでデータの設定は終了です。 ①「終了」ボタンを押下して、ダイアログを終了します。
24
①正常にデータベース設定を行った場合はスキーマ一覧が表示されます。チュートリアルでは「sampledb」を利用するため、「sampledb」の左に表示されているᐅをクリックして展開します。「Table」の左に表示されているᐅをクリックしてするとテーブル一覧が表示されます。 ②チュートリアルでは「orders」テーブルのデータを一覧表示します。「SELECT * FROM orders」と入力してテーブルのすべてのデータを選択するようにします。 ③「次へ」ボタンを押下して次ぎのウィザード・ページに移動します。
25
レポートで使う列を選択します。 チュートリアルでは①注文ID、②顧客ID、③出荷日、④受注額、⑤市村町、⑥出荷国を利用しますので、それらを選択します。
これらの列名を一つずる選択して⑦「＞」ボタンを押下することもできますが、①を選択した後に「Ctrl」キーを押しながら②から⑥の列名を選択した後に⑦「＞」ボタンを押下することもできます。 Jaspersoft Studioではレポートで使う列を「フィールド」を言います。
ここではフィールドの選択の仕方を説明を行うために、データベースからすべての列を取得してレポートで使うフィールドを選定していますが、実際に使うレポートでは使う列のみをデータベースから取得するSQL文を記述した方がパフォーマンスがよいです。
26
①選択した列名が右に移動したことを確認します。 ②「終了」ボタンを押下してレポート作成ウィザードを終了します。
27
レポート作成ウィザードが終了するとレポートレイアウトページが表示されます。
28
29
選択したフィールドをレポートに配置します。 ①「フィールド」の左のᐅをクリックします。選択してフィールド一覧が表示されます。
30
①一番上の「注文ID」をマウスでクリックした後に「Shift」キーを押したままで最後のフィールド「出荷国」をクリックするとすべてのフィールドが選択されます。 ②選択したフィールドを「詳細１」領域にドラッグ＆ドロップします。
31
フィールドを詳細領域にドロップすると①列ヘッダ領域にフィールド名のラベルが作成され、②詳細領域にフィールドのデータ表示用のテキストフィールドが作成されます。
列ヘッダ領域のラベルは一覧のヘッダになります。詳細領域のテキストフィールドは繰り返されてデータベーステーブルのデータに置き換わってレポートに表示されます。
32
ラベルとテキストフィールドの高さはデフォルトで30pxです。一覧では行間に隙間が空くため、高さを修正します。
①ラベルの左上でマウスの左ボタンをクリックして、テキストフィールドの右下までドラッグしてマウスボタンを放します。
33
①マウスでドラッグした範囲のすべてのラベル及びテキストフィールドが選択されます。
34
①「プロパティ」ビューの「外観」を選択します。 ②ラベル及びテキストフィールドを領域内の一番上に移動するためにyの値を「0px」に設定します。 ③隙間を減らすために高さ（「h」）を「15px」に設定します。 値を入力した後に別の項目または「Enter」キーを押すとレポートレイアウトに設定が反映されます。
35
①ラベルすべてが列ヘッダ領域内の一番上に配置され、高さが小さくなったことを確認します。
同じようにテキストフィールドすべてが詳細領域内の一番上に配置され、高さが小さくなったことを確認します。
36
37
今回のレポートで使わない領域があります。これらの領域もデフォルト設定では高さがあるため、レポートに隙間が空きます。高さを0pxに設定することも可能ですが、レポート定義ファイル（*.jrxmlファイル）にタグが残るため性能が若干遅くなります。そのため、これらの領域を削除します。
今回は①「ページヘッダ」、②「列フッター」、「ページフッター」、③「サマリー」領域を使わないので削除します。 マウスで①「ページヘッダ」を左クリックした後に「Ctrl」キーを押しながら②「列フッター」、「ページフッター」、③「サマリー」も左クリックします。 マウスで右クリックするとメニューが表示されるので④Deleteを選択します。
削除した領域（⑤「ページヘッダ」、⑥「列フッター」、「ページフッター」、⑦「サマリー」）は薄い色で表示されます。
38
JasperReportsはレポートレイアウトをjrxmlっと言うXMLファイルを処理します。 Jaspersoft Studioはこのjrxmlファイルをビジュアルに作成するツールです。 ①Jaspersoft Studioが生成するjrxmlを直接表示するには「ソース」タブを選択します。XML文書が表示されます。 領域はタグになります。例えば列ヘッダ領域は<columnHeader>です。 領域の高さを0に設定しても領域のタグは残ります。削除するとタグは無くなります。
39
隙間が空かないように領域の高さをラベル及びテキストフィールドと同じ高さに設定します。 マウスで①「列ヘッダ」を左クリックした後に「Ctrl」キーを押します。②「詳細1」も左クリックして選択します。 ③プロパティビューの「外観」内の「高さ」の値を「15px」に修正します。「Enter」キーを押下すると入力した値で確定されて表示されている領域の高さが変わります。
40
レポートレイアウトに一覧の題名を配置します。 ①「Palette」タブを選択します。
②表示された部品の中の「ラベル」を左クリックしてレポートレイアウトの「題名」領域にドラッグ＆ドロップします。 Jaspersoft Studioでは、左側に表示されるアウトラインビューと右側側に表示されるPaletteから要素をドラッグ＆ドロップしてレポートレイアウトに要素を追加します。 配置した要素の設定は右側に表示されるプロパティビューから行います。
41
42
43
44
45
配置したラベルの設定を変更します。 ①配置したラベルを選択します。
46
ラベルの幅を広げます。
①ラベルの左の真ん中の青い●をマウスで選択して左にドラッグします。ラベルの幅が左に伸びます。 ②同じようにラベルの右も伸ばします。
47
ラベルの位置と高さを設定します。 ①「プロパティ」タブを選択します。 ②「外観」を選択します。 ③領域内の上の位置（「y」）の値を「0px」に設定します。 ④高さ（「h」)の値を「30px」に設定します。「Enter」キーを押下すると入力した値が確定されレイアウトが更新されます。
48
題名の内容、配置、フォントサイズを変更します。 ①「ラベル」を選択します。 ②「文字列」の値に「出荷一覧」と入力して「Enter」キーを押下します。レイアウトの題名が「出荷一覧」に変更されます。 文字列の配置を中央の中心に変更します。 ③「配置」の右の中央アイコンを選択します。 ④同じように中心アイコンを選択します。 ⑤フォントを「24」に変更します。
49
①文字列「出荷一覧」はラベル内の中心に大文字で表示されていることを確認します。
50
表のタイトルに背景色、枠線を設定して、文字列の配置を中央に変更します。 ①ヘッダのラベルすべてを選択します。 「アウトライン・ビュー」の「列ヘッダ」下の「注文ID」を左クリックした後に「Shift」キーを押下します。「出荷国」を左クリックします。 ②レイアウトですべてのラベルが選択されたことを確認します。
51
背景色を設定します。 ①「外観」を選択します。
②「透明」のチェックを外します。チェックされていると設定した背景色は透明になって反映されません。 ③「背景色」アイコンを押下します。
52
色選択ダイアログが表示されます。このダイアログで背景色を選択します。 RGBの値を入力することもできますが、今回は色パレットから選択します。 ①色パレットから好みの色をクリックします。例では灰色辺りをクリックしています。 ②色を選択した後に「OK」ボタンを押下すると色が確定されます。
53
①ラベルの背景色が指定した色に変わっていることを確認します。
54
ラベル内の文字列の配置とフォントサイズを変更します。 ①「ラベル」を選択します。 文字列の配置を中央の中心に変更します。 ②「配置」の右の中央アイコンを選択します。 ③同じように中心アイコンを選択します。 ④フォントを「14」に変更します。
55
枠線を引きます。 「枠」を選択します。 枠の②上、③右、④下、⑤左をマウスでクリックして選択します。 ⑥「枠の太さ」の値を「1.0」に変更します。
56
表示するデータに枠線を設定して、文字列をインデントします。 ①テキストフィールドすべてを選択します。 「アウトライン・ビュー」の「詳細１」下の「$F{注文ID}」を左クリックした後に「Shift」キーを押下します。「$F{出荷国}」を左クリックします。 ②レイアウトですべてのテキストフィールドが選択されたことを確認します。
57
JasperReportsのレポートレイアウトには変数、データを表示するフィールド、表示す
るレポートの条件（例：日付や顧客コード）などを設けることができます。詳細は別のチュートリアルで説明します。
58
枠線を引きます。 「枠」を選択します。 枠の②上、③右、④下、⑤左をマウスでクリックして選択します。 ⑥「枠の太さ」の値を「1.0」に変更します。
59
文字の配置とインデントを設定します。 ①「テキストフィールド」を選択します。 文字列の配置を左の中心に変更します。 ②「配置」の右の左アイコンを選択します。 ③同じように中心アイコンを選択します。 ④左インデントの値を「10px」に変更します。 ⑤右インデントの値も「10px」に変更します。
60
出荷日の日付表示形式を指定します。 表示形式はレポートで表示する形式の指定です。実際の値は変わりません。 ①形式を変更するテキストフィールドを選択します。ここでは「出荷日」を選択します。 ②プロパティタブ内の「テキストフィールド」を選択します。 ③「式」に選択してフィールド名が表示されます。「$F{出荷日}」であることを確認します。 ④「パターン」に表示形式を入力します。形式はJavaのSimpleDateFormatの日時パターンです。ここでは「yyyy/MM/dd」を入力します。
61
受注額の表示形式を通貨に指定します。 ①形式を変更するテキストフィールドを選択します。ここでは「受注額」を選択します。 ②プロパティタブ内の「テキストフィールド」を選択します。
③パターンに通貨のパターンを直接入力することもできますが、今回は一覧から選びます。右の「…」ボタンを押下します。
62
①「通貨」を選択します。 ②一番上の「-10,023.12」を選択します。 ③「パターン」に選択した形式に対応したパターンが入力されます。 ④「終了」ボタンを押下してパターンを決定します。
63
①選択したパターンが「パターン」に入力されたことを確認します。
64
65
以上の操作でレポートレイアウトの設定は終了です。 レポートを実行して確認を行います。
①「プレビュー」タブを選択すると定義したレイアウトにデータで埋め込まれて表示されます。
66
デフォルトではJavaのプログラム形式で表示されます。 レポートをPDF形式で出力する場合は次ぎの手順で行います： ①「Java」の右の▼をクリックします ②表示される一覧から「PDF」を選択します。
67
①PDFリーダが開き、PDF形式のレポートが表示されます。
68
69
70
A4縦のレポート用紙をA3横に変更します。
71
①「アウトライン・ビュー」を選択します。 ②レポートの名前（一番上に表示）を選択します。
72
①「プロパティ・ビュー」から「レポート」を選択します。 ②「ページレイアウトの編集」ボタンを押下します。
73
ページレイアウト・ダイアログが表示されます。このダイアログで用紙の設定を行えます。
①「用紙」の右の▼ボタンをクリックすると用紙サイズ一覧が表示されます。ここでは「A3」を選択します。 一覧に表示されていない用紙サイズを使う場合は、一覧の一番下の「Custom」を選択して「幅」、「高さ」に用紙サイズを指定します。 必要に応じて用紙のマージンも変更することができます。 右の「列数」は段落を組む場合に使います。 今回はマージンと列数は変更しません。
74
①用紙が「A3」であることを確認します。 ②用紙の向きを横方向に変更します。 「用紙の向き」の下の「横」に変更します。 ③「OK」ボタンを押下して設定を確定します。
75
レポートの用紙サイズがA3横に変更されたことを確認します。
76
77
