建立和初始化匯出控制項

匯出控制項處理報表匯出作業的各個層面,利用下載對話方塊提示使用者,選擇在瀏覽器視窗內預覽匯出的報表,或將報表以附件形式匯出。匯出控制項是以 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);

    注意:    您可以在 ReportExportFormat 類別文件中找到有效常數清單所指定的匯出格式,ReportExportFormat 類別文件是位於 Rational Software Development Platform API Reference 的 Crystal Reports Toolkit 中。

某些格式包含額外的選項,若加以設定可自訂匯出報表的方式。例如,您可以控制某些格式的匯出頁面範圍。

設定格式特定的選項
  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://www.taiwan.businessobjects.com/
支援服務
http://www.businessobjects.com/services/support/