42 JSPベースのWebレポートに対する単純な パラメータ・フォームの作成

この章では、単純なパラメータ・フォームを含むJSPベースのWebレポートについて説明します。ペーパー・レポートに対するパラメータ・フォームを作成する場合は、Oracle Reportsオンライン・ヘルプを参照してください。この章の手順に従うと、図42-1および図42-2に示すようなレポート出力を生成できます。

図42-1 JSPパラメータ・フォーム

「図42-1 JSPパラメータ・フォーム」の説明

注意:

この図のJSPパラメータ・フォームでは、ユーザーが部門のリストからいずれかの部門を選択してデータベースに接続し、選択したパラメータに基づいてレポートを実行できます。

図42-2 ユーザー・パラメータに基づくJSPベースのWebレポート

「図42-2 ユーザー・パラメータに基づくJSPベースのWebレポート」の説明

注意:

この図のJSPベースのWebレポートでは、JSPパラメータ・フォームで選択された部門に基づいたグラフと表形式のレポートが表示されます。このレポートの作成方法は、『Oracle Reportsチュートリアル』を参照してください。

概要

この例では、JavaServer Pages（JSP）を使用して、JSPベースのWebレポートに対するHTMLパラメータ・フォームを作成します。WebレポートのJSPおよびパラメータ・フォームの概念に関する情報は、第2.2.1項「JavaServer Pages（JSP）とサーブレットについて」および第1.9.4項「Webレポートのパラメータ・フォームについて」を参照してください。
この例では、ごく単純なパラメータ・フォームの作成方法を説明します。このパラメータ・フォームではニーズに対応できない場合は、Oracle Technology Network（OTN）で高度な例を参照してください。Oracle Reportsのページ（http://www.oracle.com/technology/products/reports/index.html）で「Getting Started」をクリックし、「Getting Started with Oracle Reports」ホームページを表示します。左側にあるトピックのリストの中から「Index」をクリックします。「Collateral Type」リストで、「Examples」を選択し、「Search」をクリックします。表示された例のリストから、「Building a JSP-based Web Report with a Parameter Form」をクリックします。

使用例

この例では、部門ごとに従業員の給与を棒グラフで示すJSPベースのWebレポートと、従業員の詳細を示す表形式のレポートがあるとします。顧客から、すべての部門のデータを読み取らなくてもすむよう、特定の部門の従業員情報を実行時に表示できるようにしてほしい、との要望がありました。この例の手順では、このJSPベースのWebレポートにJSPパラメータ・フォームを追加する方法について説明します。

この例では、『Oracle Reportsチュートリアル』で作成されたレポートを使用します。この例で使用するWebレポートの作成方法を確認するには、チュートリアルに示されている手順を参照してください。

このサンプル・レポートの作成過程では、次を行います。

テキスト・エディタまたはHTMLエディタを使用して、HTMLでパラメータ・フォームを作成する。
データ・モデル・ビューおよびWebソース・ビューを使用して、Reports BuilderでHTMLパラメータ・フォームを変更し、JSPとして保存する。
データ・モデル・ビューを使用して、ユーザー・パラメータを受け入れるようターゲット・レポートの問合せを変更するように、ターゲット・レポートを設定する。
JSPパラメータ・フォームとターゲット・レポートを配布する。

単純なパラメータ・フォームを含むサンプルのJSPベースのWebレポートを表示するには、サンプル・フォルダsimplejsppfを開き、results\emprev_param.jspを開きます。このファイルの開き方の詳細は、「はじめに」の「サンプル・レポートへのアクセス」を参照してください。この章で使用されているサンプル・ファイルのリストと説明を表42-1に示します。

表42-1 レポートのサンプル・ファイル

ファイル	説明
`simplejsppf\source\paramform.html`	HTMLパラメータ・フォームのサンプル。サンプルの値リスト、フィールドおよびボタンが1つずつ含まれています。
`simplejsppf\results\aramform.jsp`	このJSPベースのWebレポートには、Reports Builderで行うパラメータ・フォームに対する変更が含まれています。
`simplejsppf\results\emprev_final.jsp`	パラメータ・フォームのターゲット・レポートとなる、ソースWebレポート。
`simplejsppf\results\emprev_param.jsp`	JSPパラメータ・フォームを使用した、最終的なJSPベースのWebレポート。

注意:

『Oracle Reportsチュートリアル』の作業を完了している場合は、第6章の終わりで作成したemprevb_<自分のイニシャル>.jspファイルも使用できます。