エクスポート コントロールの作成および初期化

エクスポート コントロールでは、レポートのエクスポートに関係するあらゆる処理を行います。エクスポート コントロールにより、エクスポートされたレポートをブラウザ ウィンドウ内でプレビューしたり、ダウンロード ダイアログを使用して添付ファイルとしてエクスポートしたりできます。エクスポート コントロールは、ReportExportControl クラスで表されます。

エクスポート コントロールを作成する
  1. 必要な Java クラスとパッケージを参照します。
  2. <%@ page import="com.crystaldecisions.report.web.viewer.ReportExportControl" %>

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

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

    <%@ page import="com.crystaldecisions.sdk.occa.report.exportoptions.ExportOptions" %>

    <%@ page import="com.crystaldecisions.sdk.occa.report.exportoptions.ReportExportFormat" %>

    <%@ page import="com.crystaldecisions.sdk.occa.report.exportoptions.RTFWordExportFormatOptions" %>

  3. ReportExportControl オブジェクトを作成します。
  4. ReportExportControl exportControl = new ReportExportControl();

ReportExportControl オブジェクトの作成が完了したら、エクスポート形式を指定する必要があります。この例では、RTF をエクスポート形式として選択しています。エクスポート形式の全一覧は、ビューア機能を参照してください。

エクスポート形式を指定する
  1. ExportOptions オブジェクトを作成します。
  2. ExportOptions exportOptions = new ExportOptions();

  3. setExportFormatType メソッドを呼び出し、形式を表す ReportExportFormat 定数をそのメソッドに渡して、エクスポート形式を指定します。
  4. exportOptions.setExportFormatType(ReportExportFormat.RTF);

    注    エクスポート形式を指定する有効な定数の一覧は、『Crystal Reports Toolkit for the Rational Software Development Platform API リファレンス』の中の ReportExportFormat クラスの説明を参照してください。

一部の形式では、レポートのエクスポート方法をカスタマイズするために設定できる、追加オプションがあります。たとえば一部の形式では、エクスポートするページ範囲を制御できます。

エクスポート形式特有のオプションを設定する
  1. 適切な形式オプション オブジェクトを作成します。
  2. この場合はエクスポート形式が RTF なので、RTFWordExportFormatOptions オブジェクトを作成します。

    RTFWordExportFormatOptions RTFExpOpts = new RTFWordExportFormatOptions();

  3. 目的のオプションを設定します。
  4. この例では、1 〜 3 ページだけをエクスポートするようにエクスポート オプションを設定します。

    RTFExpOpts.setStartPageNumber(1);

        RTFExpOpts.setEndPageNumber(3);

  5. ReportExportOptions オブジェクトの setFormatOptions メソッドを呼び出し、形式オプション オブジェクトを渡します。
  6. exportOptions.setFormatOptions(RTFExpOpts);    

エクスポート コントロールを初期化する
  1. コントロールのレポート ソースの setReportSource メソッドを呼び出し、作成したレポート ソース オブジェクトに対する参照をそのメソッドに渡して、コントロールのレポート ソースを設定します。
  2. exportControl.setReportSource(reportSource);

  3. setExportOptions メソッドを呼び出し、以前に作成した ExportOptions オブジェクトを渡します。
  4. exportControl.setExportOptions(exportOptions);

  5. setExportAsAttachment メソッドを呼び出す場合もあります。
  6. このメソッドに true を設定することによって表示されるダイアログ ボックスを使用すると、Web アプリケーションのユーザーはエクスポートしたレポートを保存してから、そのレポートを開くことができます。それ以外の場合は、エクスポートされたファイルの種類をブラウザがサポートしていれば、レポートが直接ブラウザ ウィンドウに表示されます。

    exportControl.setExportAsAttachment(true);



Business Objects
http://japan.businessobjects.com/
サポート サービス
http://japan.businessobjects.com/services/