レポート ソースの作成方法

JSP ページでエクスポート コントロールやビューアを使用するには、まずレポート ソースを取得する必要があります。

レポート ソースは、エクスポート コントロールとビューアによって使用されるレポートの単一インスタンスを表すオブジェクトです。Java Reporting Component、Page Server、および RAS を使用してレポート ソースを取得できます。

Java Reporting Component を使用してレポート ソースを作成するには、表示またはエクスポートするレポートの場所が必要です。相対パスまたは絶対パスを使用してレポートの場所を指定します。また、Java Reporting Component がレポートのデータを正しく取得するためには、レポートのデータ ソースが JNDI を通じて正しく指定されているか、レポートが JDBC データ ソースに対して設計されている必要があります。

Java Reporting Component によってレポート ソースを取得する方法は、2 つあります。1 つは、ReportClientDocument クラスを使用してレポート ソースを取得する方法です（推奨）。もう 1 つは、IReportSourceFactory2 クラスを使用する方法です。

ReportClientDocument を使用してレポート ソース オブジェクトを作成する

1. ReportClientDocument クラスがインポートされていることを確認します。

import com.crystaldecisions.reports.sdk.ReportClientDocument;

2. ReportClientDocument クラスのインスタンスを作成します。

ReportClientDocument reportClientDoc = new ReportClientDocument();

3. ReportClientDocument オブジェクトの open メソッドを呼び出して、目的のレポートのパスおよび現在のロケール設定を渡します。

String report = "/reports/sample.rpt";
reportClientDoc.open(report, 0);
Object reportSource = reportClientDoc.getReportSource();

注    上記のコードで示されるレポートの場所は、相対パスと絶対パスのどちらを使用するかによって異なります。相対パスを使用する場合、上記のレポートの場所は、<web_app_dir>/WEB-INF/lib/reports/sample.rpt になります。絶対パスを使用する場合、上記のレポートの場所は、最初は <web_app_dir>/WEB-INF/classes/reports/sample.rpt で、次に <web_app_dir>/WEB-INF/lib/reports/sample.rpt になります。

4. レポート ソースを取得したら、Java Reporting Component を使用してレポート ソースをセッション変数にキャッシュする必要があります。

session.setAttribute("reportSource", reportSource);

注    この例で使用したレポートは、チュートリアルには含まれていません。

IReportSourceFactory2 を使用してレポート ソースを作成する

1. JPEReportSourceFactory クラスと IReportSourceFactory2 インターフェイスがインポート済みであることを確認します。

<%@ page import="com.crystaldecisions.reports.reportengineinterface.JPEReportSourceFactory" %>

<%@ page import="com.crystaldecisions.sdk.occa.report.reportsource.IReportSourceFactory2" %>

2. 新しい JPEReportSourceFactory オブジェクトを作成します。

    IReportSourceFactory2 rptSrcFactory = new JPEReportSourceFactory();

3. IReportSourceFactory2 オブジェクトの createReportSource メソッドを呼び出して、目的のレポートのパスおよび現在のロケール設定を渡します。

注     String report = "/reports/sample.rpt";

注     Object reportSource = rptSrcFactory.createReportSource(report, request.getLocale());

注    

注    上記のコードで示されるレポートの場所は、相対パスと絶対パスのどちらを使用するかによって異なります。相対パスを使用する場合、上記のレポートの場所は、<web_app_dir>/WEB-INF/lib/reports/sample.rpt になります。絶対パスを使用する場合、上記のレポートの場所は最初は <web_app_dir>/WEB-INF/classes/reports/sample.rpt で、次に <web_app_dir>/WEB-INF/lib/reports/sample.rpt になります。

4. レポート ソースを取得したら、Java Reporting Component を使用してレポート ソースをセッション変数にキャッシュする必要があります。

session.setAttribute("reportSource", reportSource);

注    この例で使用したレポートは、チュートリアルには含まれていません。