前へ
次へ
ホーム > アプリケーション・コンポーネントの追加 > レポートの作成 > レポート・リージョンの出力
前へ |
次へ |
様々な形式にエクスポートすることによって、出力するクラシック・レポート・リージョンを構成できます。Oracle BI Publisherでは、Adobe Portable Document Format（PDF）、Microsoft Wordリッチ・テキスト形式（RTF）、Microsoft Excel形式（XLS）またはExtensible Markup Language（XML）がサポートされます。指定されたApache FOP代替付きOC4Jでは、PDFおよびXMLのみがサポートされます。他のサード・パーティ・レンダリング・エンジンの使用を選択すると、他の出力形式も構成されます。
リージョン・レポート出力を利用すると、アプリケーション・ユーザーは、印刷の方向、ページ・サイズ、列ヘッダーおよびページのヘッダーとフッターが事前定義されたレポートを表示および出力できます。対話モード・レポートでも、PDF、RTF、Microsoft ExcelおよびCSVへのエクスポートが可能です。対話モード・レポートの場合、カスタム・レポート・レイアウトは定義できないことに注意してください。
トピック:
|
ヒント: Oracle Application ExpressをOracle Database 11g リリース1（11.1）以上で実行している場合は、レポート出力を使用するためにネットワークを有効にする必要があります。「Oracle Database 11gのネットワーク・サービスの有効化」を参照してください。 |
PDFに出力する際に、レポート・データは外部で定義されたレポート・サーバーを使用して変換されます。アプリケーションのエンド・ユーザーが出力リンクをクリックすると、Application Expressエンジンにリクエストが送信されます。Application Expressエンジンは、レポート・データをXML形式で、レポート・テンプレートをXSL-FO形式またはRTF形式で生成します。次に外部のレポート・エンジンがデータおよびテンプレートをPDFに変換し、変換されたPDFはBI Publisher 10.1.3.2（以前のOracle XML Publisher）に付属の変換サーブレットを使用してエンド・ユーザーに表示されます。このようなアーキテクチャ上の複雑さは、エンド・ユーザーおよび開発者には意識されません。エンド・ユーザーは出力リンクをクリックするだけでよく、開発者はPDF出力をサポートするリージョンを宣言的に設定するだけです。他の形式への出力も、必要な変換サーブレットを使用して同様に行われます。
レポート・サーバーには、Oracle BI Publisher、Apache FOP付きOC4Jなどの標準的なXSL-FO処理エンジンを使用できます。Oracle BI Publisherは、より高度な機能を提供しており、マスター・ディテール・レポート、チャートなどの忠実度の高い出力要件の実現を促進します。Oracle Application Expressでは、機能の違いに対応するために、2つのレポート出力の構成オプションが提供されています。
標準サポート: （標準XSL-FO処理エンジンに付属する）組込みテンプレートを使用するか、その他のXSL-FO互換形式を指定して、レポート・リージョンおよびレポート問合せを出力できます。この設定では、RTFはサポートされません。
標準サポートは、レポート・リージョンおよびレポート問合せの宣言型書式設定に、ページ属性（ページの印刷方向、ページ・サイズ、列のヘッダー形式、ページのヘッダーおよびフッターなど）全体の基本的な制御を指定します。
拡張サポート: Oracle BI Publisher（Oracle XML Publisherとも呼ばれる）の使用許諾が必要です。拡張サポートでは、標準設定の全機能に加え、BI PublisherのWord Template Builderを使用して開発されたRTFベースのレポート・レイアウトを定義する機能が提供されます。
Oracle BI Publisherのインストールおよび構成の詳細は、「PDF Printing in Application Express 3.1」を参照してください。次のURLにアクセスしてください。
http://www.oracle.com/technology/products/database/application_express/html/configure_printing.html
|
注意: レポート出力の機能をすべて使用するには、Oracle Application Expressのサービス管理者がこの機能をサイトで有効にする必要があります。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。 |
クラシック・レポートのリージョンは、次の2つの方法で出力できます。
レポート・リージョンの出力属性の構成。リージョンに対して出力属性を構成することによって、レポート・リージョンを出力できます。「クラシック・レポート・リージョンの出力属性の構成」を参照してください。
レポート問合せの作成。レポート問合せを共有コンポーネントとして定義することで、レポートを出力できます。「レポート問合せについて」を参照してください。
レポート・リージョンおよびレポート問合せは、次の形式でダウンロードできます。
PDF: Adobe Portable Document Format。
RTF: Microsoft Word Rich Text Format。
XLS: Microsoft Excel形式。ただし、コンテンツはHTMLベースであるため、本当の.xlsファイルではありません。
HTML
XML: Extensible Markup Language。
レポート・リージョンまたはレポート問合せを書式設定するには、レポート・レイアウトと関連付けます。詳細は、「レポート・レイアウトについて」を参照してください。
レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれるSQL文とは異なり、レポート問合せには、問合せを保存すると有効化されるSQL文が含まれます。レポート問合せは、SQL文を戻すファンクションではなく、SQL文である必要があります。
レポート問合せは、レポート・レイアウトに関連付けて、書式化されたドキュメントとしてダウンロードできます。レポート・レイアウトが選択されていない場合は、汎用のレイアウトが使用されます。汎用レイアウトは、レポート問合せのテストと検証の目的で使用します。汎用レイアウト・オプションを使用する場合にソース問合せが複数定義されていると、最初の結果セットのみが出力ドキュメントに含まれます。レポートには、現行のアプリケーションのセッション・ステートを含めることができます。
これらのレポートをアプリケーションと統合することにより、エンド・ユーザーから使用できるようにします。たとえば、ボタン、リスト・アイテム、ブランチ、またはターゲットとしてURLを使用できるその他のナビゲーション・コンポーネントをレポート問合せに関連付けることができます。そのアイテムを選択すると、出力プロセスが開始します。
トピック:
「レポート問合せ」オプションの可用性は、サービス管理者がインスタンスに対してどのようなレポート出力設定を行ったかによって異なります。次のステップに示すすべてのオプションが使用可能であるとはかぎりません。
レポート問合せを作成するには、次のステップを実行します。
共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。
「レポート」で、「レポート問合せ」をクリックします。
「作成」をクリックします。
問合せを実行するには、次の情報を指定します。
レポート問合せ名: レポート問合せを識別する名前を入力します。リンク・ターゲットとしてレポート問合せを参照する際に、レポート問合せ名はリクエスト文字列の一部になります。
出力形式: レポートの出力形式を指定します。有効なオプションは、次のとおりです。
PDF: Adobe Portable Document Format。
Word: Microsoft Word Rich Text Format。
Excel: Microsoft Excel形式。ただし、コンテンツはHTMLベースであるため、本当の.xlsファイルではありません。
HTML
XML: Extensible Markup Language。
アイテム: 形式の値を保持するアイテムを選択します。これを使用すると、出力形式を実行時に決定できます。
ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは、次のとおりです。
添付ファイル: ユーザーがレポート問合せのダウンロード・ボタンをクリックすると、ファイルを開くか、または保存するかを尋ねるダイアログ・ボックスが表示されます。
インライン: レポート問合せドキュメントをブラウザのウィンドウ内に表示します。
セッション・ステート: セッション・ステートの値（レポートのXML構造のページ・アイテムの値など）を参照するには、このチェック・ボックスを選択します。
「次へ」をクリックします。
「SQL問合せ」にSQL文を直接入力するか、「クエリー・ビルダー」をクリックして、クリックやポイントによってSQL文を作成します。
SQL文でアプリケーションおよびページ・アイテムを参照する場合は、バインド変数として参照します。「バインド変数の設定」をクリックすると、各バインド変数について値を入力し、問合せをテストして、目的の出力が戻されることを確認できます。
「定義のダウンロード」で、次の項目を指定します。
レポート・レイアウトのデータ・ソース: このオプションは、レポート定義のエクスポート・ファイルをダウンロードするために使用します。「XMLデータ」または「XML Schema」を選択してから、「ダウンロード」をクリックします。
「XML Schema」を選択すると、XSDファイル（XML構造のXMLスキーマ定義）が作成されます。
問合せの追加: このボタンは、レポート問合せに問合せを追加する場合にクリックします。問合せを追加すると、複数の出力コンポーネントがある複合レポート（たとえば、異なる2つの問合せに基づいたチャートおよびレポート）を作成できます。
レポート問合せの作成: このボタンをクリックすると、ウィザードが早期に終了します。「レポート・レイアウトのソース」には、汎用のレポート・レイアウトが使用されることになります。
「次へ」をクリックします。
「レポート・レイアウトのアップロード」で、次の項目を指定します。
レポート・レイアウトのソース: レポート・レイアウトの取得方法を指定します。レポート・ベース・ファイルのレイアウトを選択した場合は、レイアウト名およびレポート・レイアウト・ファイルを指定する必要があります。
レイアウト名: レイアウト名を入力します（オプション）。デフォルトは、レポート問合せの名前です。
レポート・レイアウト・ファイル: 「参照」をクリックし、Rich Text Format（RTF）を選択します。
「次へ」をクリックします。
「確認」で、次のステップを実行します。
問合せ名: 問合せを識別します。
レポート・レイアウト: 選択したレポート・レイアウトを識別します。
出力形式: このレポート問合せの形式を識別します。
アイテムから派生: 形式情報を保持するアイテムを識別します。
URL: このレポートをアプリケーションに統合するには、表示されたURLをボタン、リスト・アイテム、リンクまたは他のナビゲーション・コンポーネントに対するターゲットとして使用します。これにより、たとえば、エンド・ユーザーはボタンをクリックして、出力プロセスを開始できます。
テスト・レポート: これをクリックして、レポートのプレビューを表示します。汎用レポート・レイアウトを使用するように指定している場合は、「テスト・レポート」をクリックしても出力は生成されません。
「終了」をクリックします。
レポート問合せは、「共有コンポーネント」に作成および保存されます。
レポート問合せを編集するには、次のステップを実行します。
共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。
「レポート」で、「レポート問合せ」をクリックします。
レポート問合せページで、ページ上部のナビゲーション・バーを使用して名前で問合せを検索したり、またはページの表示を変更できます。たとえば、「ビュー」リストから選択して、デフォルトの表示を変更できます。使用可能なオプションは次のとおりです。
アイコン: （デフォルト）各問合せを大きいアイコンとして表示します。問合せを編集するには、該当するアイコンをクリックします。
詳細: 各問合せをレポートで1行に表示します。問合せを編集するには、名前をクリックします。
目的のレポート問合せを選択します。レポート問合せの編集ページで、情報を編集します。
「変更の適用」をクリックします。
レポート問合せをコピーするには、次のステップを実行します。
共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。
「レポート」で、「レポート問合せ」をクリックします。
レポート問合せページで、「コピー」をクリックします。
「レポート問合せのコピー」で、コピーする問合せを選択して、レポート問合せの名前を入力し、「コピー」をクリックします。
コピーが問合せリストに表示されます。
クラシック・レポート・リージョンまたはレポート問合せのどちらかをフォーマットするには、レポート・レイアウトと関連付けます。レポート・レイアウトを使用すると、印刷用形式でデータをレンダリングできます。レポート・レイアウトを選択しない場合は、デフォルトのXSL-FOレイアウトが使用されます。対話モード・レポートのリージョンのレンダリングでは、常にデフォルトのXSL-FOレイアウトが使用されます。
レポート・レイアウトを作成して使用すると、次のことができるようになります。
レポート・リージョンのデフォルトのレイアウトおよびOracle Application Expressで用意されているレポート問合せの汎用レイアウトを利用できます。
コードをコピーしてカスタマイズすることによって、レポート・リージョンの組込みXSL-FOベースのレイアウトが利用できます。レポート・リージョンに対して、ページ・サイズ、フォント、色などを制御する様々な属性を編集できます。
RTFまたはXSL-FOレポート・レイアウトを作成してレポートのルック・アンド・フィールをカスタマイズできます。RTFレポート・レイアウトを使用するには、Oracle Application Expressのサービス管理者が、そのサイトに対して詳細設定を選択している必要があります。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
トピック:
レポート・レイアウトは、次のいずれかのオプションに基づいて作成できます。
汎用列: 汎用レポート・レイアウトはほとんどの問合せ結果セットに使用できます。このレイアウトを使用すると、出力可能なドキュメントの生成時に、列の数が自動的に調整されます。
多くのレポート・レイアウト属性は、組込みのデフォルトXSL-FOレイアウトを使用して、レポート・リージョンに対して宣言的に定義できます。レポート・レイアウトを追加制御する必要がある場合は、このステップによりカスタマイズ可能な組込みのデフォルトXSL-FOレイアウトのコピーを作成できます。
名前付き列: 名前付き列のレポート・レイアウトは、問合せ固有のレポート・レイアウトで、問合せ結果セットに含まれる列の定義済リストで使用できるよう設計されています。このレイアウト・タイプはページ・アイテムおよび問合せ列の位置を正確に制御する必要がある場合に、個別に設計されたレイアウトで使用されます。
「レポート・レイアウト」オプションの可用性は、サイト管理者がサイトでどのようなレポート出力設定を行ったかによって異なります。これらのステップに示されたすべてのオプションが使用可能であるとはかぎりません。
レポート・レイアウトを作成するには、次のステップを実行します。
共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。
「レポート」で、「レポート・レイアウト」をクリックします。
「作成」をクリックします。
レポート・レイアウトの作成ウィザードが表示されます。
「レポート・レイアウト・タイプ」で、オプションを選択し、「次へ」をクリックします。
汎用列(XSL-FO): このレイアウトは、デフォルトのテンプレートに事前移入され、ユーザーのニーズにあわせて編集可能です。
名前付き列(RTF): このレイアウトはRTFファイルとしてアップロードされます。
名前付き列(XSL-FO): このレイアウトはXSL-FOファイルとしてアップロードされます。
「レイアウト・ソース」で、該当する情報を確認および編集します。このページに表示されるオプションは、選択したレイアウト・タイプによって異なります。
「汎用列」を選択した場合は、次のステップを実行します。
レポート・レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際にレポート・レイアウトを識別するための名前を入力します。
レポート・レイアウト: レポート・レイアウトは、ページ書式のXSL-FOベースの定義です。ページ・サイズ、向き、フォント、スタイルなどを定義する属性は、すべてこのセクションで定義されます。
有効な置換文字列のリストおよびその他の情報のリストを表示するには、アイテム・ラベル「レポート・レイアウト」をクリックします。個別のヘルプ・ウィンドウが開きます。
レポートの列ヘッダー: レポート・ヘッダー行の各セルの外観を定義します。
レポート列: すべてのレポート行に対する各セルの外観を定義します。
レポート列の幅: 実行時に計算されるか、またはレポート・リージョンのレポート列定義から導出できます。
名前付き列を選択した場合は、次のステップを実行します。
レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際にレポート・レイアウトを識別するための名前を入力します。
レポート・レイアウト・ファイル: レポート・レイアウトが含まれるファイルをアップロードします。
汎用列のレポート・レイアウトを直接Application Expressで編集できます。ただし、名前付き列のレポート・レイアウトを編集するには、現行のファイルをダウンロードしてそれを編集し、再度アップロードする必要があります。
レポート・レイアウトを編集するには、次のステップを実行します。
共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。
「レポート」で、「レポート・レイアウト」をクリックします。
レポート・レイアウト・ページで、編集するレイアウトを選択します。
汎用列レイアウトの場合は、レポート・レイアウトの編集ページで直接レイアウトを編集してから、「変更の適用」をクリックします。
名前付き列のレイアウトの場合は、「ダウンロード」をクリックして、コンピュータにファイルを保存します。
ファイルを編集して、新しいレポート・レイアウトとして更新されたバージョンをアップロードします。
レポート・レイアウトをコピーして編集および保存できます。
レポート・レイアウトをコピーするには、次のステップを実行します。
共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。
「レポート」で、「レポート・レイアウト」をクリックします。
レポート・レイアウト・ページで、「コピー」をクリックします。
レポート・レイアウトのコピー・ページで、コピーするレイアウトを選択して、コピーの名前を入力し、「コピー」をクリックします。
コピーがレイアウト・リストに表示されます。
レポート・リージョンを出力する方法の1つは、出力属性を構成する方法です。構成後、これらの属性は現行のリージョンのみに適用され、リージョンのコンテキスト外では使用できません。
インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。
出力用にクラシック・レポート・リージョンを構成するには、次のステップを実行します。
アプリケーションで、出力するクラシック・レポート・リージョンを含むページを選択します。
ページ定義が表示されます。
「リージョン」で、出力するリージョンの横にある「レポート」をクリックします。
「出力属性」タブをクリックします。
「出力」で、次の該当する情報を指定します。
レポート出力の有効化: 「はい」を選択します。
リンク・ラベル: 出力プロセスを開始するリンクのテキストを入力します。
レスポンス・ヘッダー: Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがブラウザに送信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置（「ファイルの表示形式」を使用）およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。
ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは、次のとおりです。
添付ファイル: ユーザーがレポート問合せのダウンロード・ボタンをクリックすると、ファイルを開くか、または保存するかを尋ねるダイアログ・ボックスが表示されます。
インライン: レポート問合せドキュメントをブラウザのウィンドウ内に表示します。
（オプション）ファイル名: ダウンロードされるファイルの名前を入力してください。空白にすると、リージョン名がファイル名として使用されます。
出力形式: 出力オプションを選択します。
アイテム: 出力形式を実行時に決定します。形式の値を保持するアプリケーションまたはページのアイテムを選択します。
レポート・レイアウト: 組込みの汎用レポート・レイアウトを使用する場合は、「デフォルト・レポート・レイアウト」を選択します。自分または管理者が作成したレポート・レイアウトを選択することもできます。カスタムXSL-FOレポート・レイアウトを構築する場合に使用可能な置換文字列のリストについては、アイテム・ヘルプを参照してください。
プリント・サーバーの上書き: 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべての作業領域について一元的に設定されます。詳細は、Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。
出力URL: レポート・リージョンは、標準の出力リンクまたはページ・ボタンを使用して出力できます。ボタンを使用する場合は、リンク・ラベルを削除し、ページにボタンを作成し、この属性に示されるURLをボタン・ターゲットとして使用します。
残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。
「レポート列」で、各列の幅を指定します。
デフォルトでは、各列の幅は同じになります。「合計幅」は表示専用フィールドであり、すべての列幅の合計を示します。個々の列の幅を変更すると、「合計幅」は自動的に再計算されます。「列幅の単位」が「ポイント」ではなく「割合」に設定されている場合は、列幅の合計を100以下にする必要があります。
「列幅のリセット」ボタンをクリックすると、「列幅の単位」が「割合」になり、すべての列幅がそれぞれのデフォルト値に戻ります。「再計算」ボタンをクリックすると、列幅の割合は現在の値を維持したままで、合計幅が100%以下になるように、すべての列幅が縮小されます。
「変更の適用」をクリックします。
対話モード・レポートの出力属性は、クラシック・レポートの場合とは異なり、デフォルトのXSL-FOレイアウトのみを使用できます。また、この画面から直接開始するのではなく、「レポート属性」の「ダウンロード」セクションからのみ開始できます。構成した属性は、現行のリージョンのみに適用され、リージョンのコンテキスト以外では使用できません。
インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。
出力用に対話モード・レポート・リージョンを構成するには、次のステップを実行します。
アプリケーションで、出力する対話モード・レポート・リージョンを含むページを選択します。
ページ定義が表示されます。
「リージョン」で、出力するリージョンの横にある「対話モード・レポート」をクリックします。
「出力属性」タブをクリックします。
「出力」で、次の該当する情報を指定します。
レスポンス・ヘッダー: Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがブラウザに送信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置（「ファイルの表示形式」を使用）およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。
コンテンツ配置: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは、次のとおりです。
添付ファイル: ユーザーがレポート問合せのダウンロード・ボタンをクリックすると、ファイルを開くか、または保存するかを尋ねるダイアログ・ボックスが表示されます。
インライン: レポート問合せドキュメントをブラウザのウィンドウ内に表示します。
プリント・サーバーの上書き: 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべての作業領域について一元的に設定されます。詳細は、Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。
残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。
「変更の適用」をクリックします。