レポート用のコンポーネン

コンポーネントをレポートレイアウトに配置するには、パレット・ビューからそのコンポーネントを配置したい領域にドラッグ＆ドロップします。新しくコンポーネントが作成されます。配置する度に新しいコンポーネントが配置されます。
コンポーネントを削除する場合は、削除したいレポートレイアウト上のコンポーネントを右クリックして「削除」を選択します。パレット・ビューからコンポーネントを削除することはできません。

コンポーネントは次の2通りで選択することができます：

• レポートレイアウトに配置されているコンポーネントをクリックする
• アウトライン・ビューから、コンポーネントが配置されれいる領域を展開して、表示されるコンポーネント一覧からコンポーネントを選択する

複数のコンポーネントのプロパティを一斉に変更したい場合は、複数のコンポーネントを選択します。
複数のコンポーネントを選択する場合は、マウスの左ボタンを押下しながら選択したいコンポーネントを囲むか、Shiftキーを押下しながら選択したいコンポーネントを選択します。
選択されている状態でプロパティ・ビューからプロパティを編集すると、選択されているすべてのプロパティの値が変更されます。選択されたコンポーネントの共通プロパティが既に設定されている場合は、値が同じであればその値が表示されますが、値が異なっている場合は空白となります。また、異なる種類のコンポーネントが選択されている場合は、プロパティ・ビューには共通したプロパティのみが表示されます。共通していないプロパティは個別に編集してください。

次の複数の方法でコンポーネントの位置を調整することができます：

グリッドを使ての位置調整
グリッド線に合わせてコンポーネントを配置することができます。
グリッド線を表示するには、「表示」－＞「グリッドを表示」を選択します。
コンポーネントをグリッド線に合わせる場合は、「表示」－＞「グリッド線に合わせる」を選択します。

領域を使ての位置調整
コンポーネントの左上の座標はコンポーネントが配置されている領域又はフレームの左上からの相対位置です。
コンポーネントを別の領域に移動する場合は、アウトライン・ビューからコンポーネントを別の領域にドラッグ＆ドロップして下さい。
注：レポートレイアウトからコンポーネントを別の領域にドラッグ＆ドロップした場合は、画面上では別の領域に配置されたように見えますが、実際には別の領域に移動されていません。そのため、レポートを生成するとコンポーネントが領域外に配置されているのでエラーになります。
注：コンポーネントの全体が1つの領域に収まっていないとエラーになります。収まっていない場合は、領域の大きさを拡大するか、コンポーネントの大きさを縮小してください。

ガイド線を使ての位置調整
コンポーネントを移動または大きさを変える場合、Jaspersoft Studioは領域、他コンポーネントを考慮してガイド線を表示します。
ガイド線を予め表示したい場合は、ルーラー目盛りをクリックして表示されるガイド線を設定したい位置までドラッグします。
ガイド線を削除するには、ルーラーでガイド線をレポートレイアウトの左及び上へドラッグします。

プロパティを使っての位置調整
プロパティ・ビューからコンポーネントのx/y座標を指定することができます。
コンポーネントをレポートレイアウト又はアウトライン・ビューから選択して、プロパティ・ビューの「外観」タブのX及びYに座標を入力します。

Jaspersoft Studioの線とは長方形の対角線です。デフォルトでは線の色は前景色で、線幅は1ピクセルです。線をレポートレイアウトに配置してから、プロパティ・ビューで線色、線幅などを設定を行ってください。
ノート：対角線のため、角度があります。水平線や垂直線を描く場合は、線コンポーネントではなく、領域の枠線、フレームなどコンポーネントの枠線、及び長方形コンポーネントを使うことを推奨します。

長方形コンポーネントは他コンポーネントの回りに線を引く場合に使います。デフォルトでは線の色は前景色で、線幅は1ピクセルです。
Jaspersoft Studioの楕円は長方形の中に描かれます。デフォルトでは線の色は前景色で、線幅は1ピクセルです。透明でない場合は楕円の背景色は楕円が配置された領域及びコンポーネントの背景色になります。

画像コンポーネントはGIF, PNG, JPEGなど画像をレポートに表示する場合に使います。
画像コンポーネントをレポートレイアウトにドラッグ＆ドロップすると「画像配置」ダイアログが表示されます。このダイアログで画像の場所を指定します。即ち、Jaspersoft Studioは画像そのものを保存しません。画像のパス及びURLのみを保存します。画像はレポートが生成される時に読み込まれてレポートに埋め込まれます。画像のパスにはデータベースのフィールドや変数の値を指定することもできます。

注1：画像のパスにはファイルシステムの絶対パス（ドライブ名を含めたパス）を指定することもできます。但し、レポートを異なる環境で使う場合はパスが異なるのでレポートの作成中にエラーになります。
注2：画像コンポーネントの大きさを実際の画像の大きさよりも大きくすると、階層度が落ちます。

画像コンポーネント、テキストコンポーネント、固定文字列コンポーネントなどでは余白を指定することができます。余白とはコンポーネントの枠から内容を表示する間隔です。
余白は次のように設定できます：

1. コンポーネントを選択
2. プロパティ・ビューの「枠」タブを選択
3. 余白に値（ピクセル）を入力

レポートの同じ文字列を表示する場合は、固定文字コンポーネントを使うことができます。固定文字コンポーネントに文字列を設定する場合は次の手順で行います：

1. 文字列を設定する固定文字コンポーネントを選択する
2. プロパティ・ビューの「固定文字列」タブを選択する
3. 項目「文字列」に文字列を入力する。文字列を直接記述してください。引用符で囲わないでください。

テキストコンポーネントは文字列を表示します。固定文字列コンポーネントと同じように固定文字列を表示することもできますが、レポートを生成する時に動的に文字列を設定したり、表示形式を指定することができます。
テキストコンポーネントに固定文字列を設定する場合は次の手順で行います：

1. 文字列を設定する固定文字コンポーネントを選択する
2. プロパティ・ビューの「テキスト」タブを選択する
3. 項目「定義」に文字列を入力します。文字列は次のように引用符で囲んでください：
   "テキストフィールド"

テキストコンポーネントを利用された場合は、静的文字列の他にフィールドの値、変数の値、リソースバンドルの値なども表示することができます。また、日付、時刻、数字、通貨などを表示する場合は表示形式を指定することもできます。
表示形式は次の手順で指定します：

1. 文字列を設定する固定文字コンポーネントを選択する
2. プロパティ・ビューの「テキスト」タブを選択する
3. 項目「パターン」に表示形式を指定する

アンカーとはページの箇所を特定する位置付けです。ハイパーリンクにアンカーを指定すると、ページ内に設定されたアンカーの箇所が表示されます。

ブックマークを定義すると、レポートをPDF形式で出力した場合にPDFブックマークも生成されます。アンカーを使う場合は、「ブックマークレベル」を1以上に設定してください。

ハイパーリンクを設定すると、レポートで設定した箇所をクリックすると別のレポート及びWebページを表示することができます。なお、ハイパーリンクは文字列だけでなく、グラフの部分に設定することもできます。例えば円グラフの場合は、スライス毎に異なるハイパーリンク先を設定することができます。棒グラフの場合は、棒毎に異なるハイパーリンク先を設定することができます。

1. ハイパーリンクを設定するコンポーネントを選択します
2. プロパティ・ビューから「ハイパーリンク」タブを選択します
3. 「リンク先」を設定します。 自分（デフォルト）：同じウィンドウにページを開く（即ち、ページをリンク先に移動する）
   ブランク：新しいウィンドウを開く（HTML及びPDF形式に出力する場合に使う）
   トップ：現ウィンドウで開く。フレーム内で開ければいる場合は、フレーム無で表示する。HTMLとPDF形式で出力する場合に使う。
   親：親ウィンドウで表示する。HTMLとPDF形式で出力する場合に使う。
4. 「リンクタイプ」ドロップダウンリストから「なし」、「参照」、「ローカルアンカー」、「リモートアンカー」、「リモートページ」、「リモート実行」かのいづれを選択する。
5. ハイパーリンクを設定する条件に付ける場合は「ハイパーリンク条件」ボタンを押下して条件を入力します。
6. ツールチップを設定する場合は「ハイパーリンクツールチップの定義」ボタンを押下して定義を入力します。
7. レポートを保存します。

Jaspersoft Studioには6種類のハイパーリンクが用意されています：参照、ローカルアンカー、ローカルページ、リモートアンカー、リモートページ、レポート実行。それ以外のハイパーリンクタイプを開発してJasperReportにプラグインすることができます。

次はJaspersoft Studioが標準でサポートしているハイパーリンクとその説明です：

ハイパーリンクにパラメータを設定する場合、リンクパラメータテーブルを使って定義することができます。パラメータを式で定義することができます。パラメータはURLに追加されるので、文字列である必要がありますが、カスタムリンクタイプを使う場合は別の型のパラメータを使いたい場合があります。

マウスカーソルがハイパーリンクが設定された要素の上に移動された場合に表示する文字列です。