レポート・リージョンの出力

8.12 レポート・リージョンの出力

いくつかの異なる形式にエクスポートすることによって、出力するレポート・リージョンを構成します。

ヒント:

外部プリント・サーバーを構成した場合は、レポート出力を使用するようにネットワーク・サービスを有効にする必要があります。「Oracle Databaseでのネットワーク・サービスの有効化」を参照してください。

関連項目:

8.12.1 レポート出力について

リージョン・レポート出力を利用すると、アプリケーション・ユーザーは、印刷の方向、ページ・サイズ、列ヘッダーおよびページのヘッダーとフッターが事前定義されたレポートを表示および出力できます。クラシック・レポート、対話モード・レポートおよび対話グリッドでも、PDF、Microsoft Excel、HTMLおよびカンマ区切り値(CSV)へのエクスポートが可能です。その他のエクスポート形式では、外部プリント・サーバーを使用する必要があります。

Oracle APEXでは、3つのレポート出力構成オプションが提供されています。

なし(ネイティブ): 外部プリント・サーバーを使用しない場合は、このオプションを選択します。このオプションを使用すると、CSV、HTML、PDFおよびXLSXを含む基本的な出力機能を使用できます。
Oracle BI Publisher: Oracle BI Publisher(Oracle XML Publisherとも呼ばれる)の使用許諾が必要です。このオプションによって、レポートの問合せ結果を取得し、Oracle BI Publisherを使用して、XMLからRTF形式に変換できるようになります。このオプションは、APEX内でのレポート出力用に、独自にカスタマイズしたRTFまたはXSL-FOのテンプレートをアップロードする場合に選択します。

Oracle BI Publisherでは、Adobe Portable Document Format(PDF)、Microsoft Wordリッチ・テキスト形式(RTF)、Microsoft Excel形式(XLS)またはExtensible Markup Language(XML)がサポートされます。他のサード・パーティ・レンダリング・エンジンの使用を選択すると、他の出力形式も構成されます。
外部(Apache FOP): 外部J2EEサーバーでApache FOPを使用している場合に、このオプションを選択します。このオプションによって、APEXで提供されるデフォルトのテンプレートおよび独自にカスタマイズしたXSL-FOテンプレートを使用して、レポート問合せの作成およびレポート・リージョンの出力が含まれる、基本的な出力機能が使用できるようになります。
Oracle REST Data Services: Oracle REST Data Services (旧名称はAPEXリスナー)リリース2.0以降を使用している場合は、このオプションを選択します。このオプションによって、APEXで提供されるデフォルトのテンプレートおよび独自にカスタマイズしたXSL-FOテンプレートを使用して、レポート問合せの作成およびレポート・リージョンの出力が含まれる、基本的な出力機能が使用できるようになります。

ノート:

「Oracle REST Data Services」オプションでは、外部出力サーバーが必要なく、かわりに、レポート・データおよびスタイルシートがリスナーにダウンロードされ、リスナーによってPDF形式にレンダリングされてから、クライアントに送信されます。この設定のPDFドキュメントはデータベースに戻されないため、Oracle REST Data Servicesベースの構成を使用する場合、出力APIはサポートされません。

ノート:

PDFレポートを生成する機能は、Oracle REST Data Services (ORDS)リリース19.4で削除されました。

ノート:

APEXインスタンス管理者は、インスタンスのレポート出力構成を変更できます。『Oracle APEX管理ガイド』のインスタンスのレポート出力の構成

親トピック: レポート・リージョンの出力

8.12.2 PDFへのレポート出力について

APEXでは、PDFへの基本レポートの出力がネイティブでサポートされています。レポート・サーバーは、レポートの完全な制御および拡張レイアウトが必要な場合に使用します。

親トピック: レポート・リージョンの出力

8.12.3 アプリケーション・レベルでのレポート出力の構成

アプリケーションのプリント・サーバー・タイプを構成するには、「アプリケーション定義」ページで「プリント・サーバー・タイプ」属性を編集します。アプリケーション・レベルのプリント・サーバー・タイプは、インスタンス管理の同様の設定をオーバーライドします。

アプリケーション・レベルでレポート出力を構成するには:

ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページが表示されます。
アプリケーションのホームページから、定義ページに、次の2通りの方法でアクセスできます。
- 「アプリケーション定義の編集」ボタンをクリックします。
- 「共有コンポーネント」からの場合:
  - 「共有コンポーネント」をクリックします。
  - 「アプリケーション・ロジック」で、「アプリケーション定義」をクリックします。
定義ページが表示されます。
レポート出力:
1. プリント・サーバー・タイプ - 「プリント・サーバー・タイプ」では、アプリケーションのプリント・サーバーを制御します。この設定は、「管理サービス」の同様の設定を上書きします。オプションは次のとおりです
  - ネイティブ出力: ネイティブ出力を使用します。外部プリント・サーバーは必要ありません。
  - リモート・プリント・サーバー: ワークスペース・ユーティリティで構成されているプリント・サーバー・タイプのリモート・サーバーを選択します。
  - インスタンス設定の使用: インスタンス管理で定義されているレポート出力設定を使用します。
2. 「変更の適用」をクリックします。
リモート・プリント・サーバーを追加するには:
1. 「リモート・プリント・サーバーの追加」ボタンをクリックします。
  「リモート・プリント・サーバーの追加」ウィザードが表示されます。
2. プリント・サーバー・タイプ - プリント・サーバーのタイプを選択します。オプションは次のとおりです。
  - Oracle Analytics Publisher - このオプションは、有償版のOracle Analytics Publisherを使用している場合に選択します。このオプションによって、レポートの問合せ結果を取得し、Oracle Analytics Publisherを使用して、XMLからRTF形式に変換できるようになります。このオプションは、APEX内でのレポート出力用に、独自にカスタマイズしたRTFまたはXSL-FOのテンプレートをアップロードする場合に選択します。
  - APEX Office Print: APEX Office Printを使用している場合は、このオプションを選択します。
  この後に表示される内容は、「プリント・サーバー・タイプ」の選択に応じて異なります。
「プリント・サーバー・タイプ」が「Oracle Analytics Publisher」の場合は、次の項目を構成します。
1. リモート・プリンタ・サーバーの追加:
  - プリント・サーバー・タイプ - 「Oracle Analytics Publisher」を選択します。
  - 名前 - ここにはリモート・サーバー・オブジェクトの名前を入力します。リモート・サーバー名は、ワークスペース内で一意である必要があります。
  - 静的識別子 - 静的IDを使用して、APIコールでリモート・サーバーを参照します。
  - エンドポイントURL - 外部プリント・サーバーのエンドポイントURLを入力します。
  - 「次」をクリックします。
2. リモート・プリント・サーバー資格証明の追加:
  - 認証が必要です - リモート・プリント・サーバーに認証を使用するかどうかを決定します。詳細は、フィールドレベル・ヘルプを参照してください。
  - 名前 - Web資格証明のわかりやすい名前を入力します。この名前はワークスペース内で一意である必要があります。
  - 静的識別子 - 静的IDを使用して、APIコールでWeb資格証明を参照します。
  - ユーザー名 - 基本認証のユーザー名を入力します。APEXでは、この情報を暗号化して保存しません。
  - パスワード - 基本認証のパスワードを入力します。APEXでは、この情報を暗号化して保存するため、クリア・テキストで回収できなくなります。
  - 「変更の適用」をクリックします。
「プリント・サーバー・タイプ」が「APEX Office Print」の場合は、次の項目を構成します。
1. リモート・プリント・サーバーの追加:
  - プリント・サーバー・タイプ - 「APEX Office Print」を選択します。
  - 名前 - ここにはリモート・サーバー・オブジェクトの名前を入力します。リモート・サーバー名は、ワークスペース内で一意である必要があります。
  - 静的識別子 - 静的IDを使用して、APIコールでリモート・サーバーを参照します。
  - エンドポイントURL - 外部プリント・サーバーのエンドポイントURLを入力します。
  - HTTPSホスト名: HTTPSリクエストに対してリモート・サーバーの証明書の共通名(CN)と照合するホスト名。これは、*.example.comのようなドメイン名でもある場合があります。NULLである場合、特定のURL内のホスト名が使用されます。
  - 「次」をクリックします。
2. リモート・プリント・サーバー資格証明の追加:
  - 認証が必要です - リモート・プリント・サーバーに認証を使用するかどうかを決定します。詳細は、フィールドレベル・ヘルプを参照してください。
  - 名前 - Web資格証明のわかりやすい名前を入力します。この名前はワークスペース内で一意である必要があります。
  - 静的識別子 - 静的IDを使用して、APIコールでWeb資格証明を参照します。
  - APIキー - 認証のためのAPIキーを入力します。APEXでは、この情報を暗号化して保存するため、クリア・テキストで回収できなくなります。
  - 「変更の適用」をクリックします。

ノート:

リモート・サーバーの作成
Oracle APEX管理ガイドの完全開発環境でのレポート出力の構成

親トピック: レポート・リージョンの出力

8.12.4 クラシック・レポートの出力メソッドについて

クラシック・レポートのリージョンは、次の2つの方法で出力できます。

レポート・リージョンの出力属性の構成。リージョンに対して出力属性を構成することによって、レポート・リージョンを出力できます。「クラシック・レポート出力属性の構成」を参照してください。
レポート問合せの作成。レポート問合せを共有コンポーネントとして定義することで、レポートを出力できます。「レポート問合せの定義によるレポート・リージョンの印刷」を参照してください

レポート・リージョンおよびレポート問合せは、次の形式でダウンロードできます。

PDF: Adobe Portable Document Format。
RTF: Microsoft Word Rich Text Format。
Excel: Microsoft Excel形式。BI Publisherがプリント・サーバーとして構成され、カスタム・レポート・レイアウトが指定されている場合、コンテンツはHTMLベースであるため、エクスポートは本当の.xlsファイルではありません。
HTML
XML: Extensible Markup Language。

レポート・リージョンまたはレポート問合せを書式設定するには、レポート・レイアウトと関連付けます。

ヒント:

また、アイテムによって出力結果を指定させることもできます(このようなアイテムは実行時に出力形式を決定します)。形式値を保持するアイテムを選択します。有効な値は、「PDF」、「RTF」(ドキュメントをMicrosoft Wordで開く)、「XLS」(ドキュメントをMicrosoft Excelで開く)および「HTML」(ドキュメントをHTMLファイルとしてダウンロードする)です。

親トピック: レポート・リージョンの出力

8.12.5 クラシック・レポート出力属性の構成

レポート・リージョンを出力する方法の1つは、出力属性を構成する方法です。構成した属性は、現行のリージョンのみに適用され、リージョンのコンテキスト以外では使用できません。

出力用にクラシック・レポート・リージョンを構成するには:

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブで、レポートを含むリージョンを選択します。
「出力」属性を有効にします。
1. プロパティ・エディタで、「属性」タブを選択します。
2. 「出力」で、「有効」を「オン」に設定します。
出力属性を構成します。
1. プロパティ・エディタで、「出力」タブを選択します。
2. 適切な出力属性を編集します。
  
  ヒント:
  
  属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。
変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

クラシック・レポートの出力メソッドについて
Oracle APEX管理ガイドのインスタンスのレポート出力の構成

親トピック: レポート・リージョンの出力

8.12.6 レポート問合せについて

レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれるSQL文とは異なり、レポート問合せには、問合せを保存すると有効化されるSQL文が含まれます。レポート問合せは、SQL文を戻すファンクションではなく、SQL文である必要があります。

関連項目:

レポート問合せの定義によるレポート・リージョンの印刷

親トピック: レポート・リージョンの出力

8.12.7 レポート・レイアウトについて

クラシック・レポート・リージョンまたはレポート問合せのどちらかをフォーマットするには、レポート・レイアウトと関連付けます。レポート・レイアウトを使用すると、印刷用形式でデータをレンダリングできます。レポート・レイアウトを選択しない場合は、デフォルトのXSL-FOレイアウトが使用されます。対話モード・レポートのリージョンのレンダリングでは、常にデフォルトのXSL-FOレイアウトが使用されます。

親トピック: レポート・リージョンの出力