Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース4.2 for Oracle Database 12c B71338-03 |
|
前 |
次 |
いくつかの異なる形式にエクスポートすることによって、出力するレポート・リージョンを構成できます。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 12cのネットワーク・サービスの有効化」を参照してください。 |
レポートをPDFに出力するには、インスタンスレベルで定義したレポート・サーバーを使用して、データを変換する必要があります。エンド・ユーザーの観点では、単に出力リンクをクリックします。ただし、開発者の観点では、PDF出力をサポートするリージョンを宣言的に作成する必要があります。
Oracle Application Expressでは、3つのレポート出力構成オプションが提供されています。
Oracle Application Expressリスナー: Oracle Application Expressリスナー2.0以上を使用している場合に、このオプションを選択します。このオプションによって、Application Expressで提供されるデフォルトのテンプレートおよびカスタマイズしたXSL-FOテンプレートを使用して、レポート問合せの作成およびレポート・リージョンの出力を含む基本的な出力機能が使用できるようになります。
注意: Oracle Application Expressリスナーでは、外部出力サーバーが必要なく、かわりに、レポート・データおよびスタイルシートがリスナーにダウンロードされ、リスナーによってPDF形式にレンダリングされてから、クライアントに送信されます。この設定のPDFドキュメントは、データベースに戻されるため、Oracle Application Expressリスナーベースの構成を使用する場合、出力APIはサポートされません。 |
外部(Apache FOP): 外部J2EEサーバーでApache FOPを使用している場合に、このオプションを選択します。このオプションによって、Application Expressで提供されるデフォルトのテンプレートおよびカスタマイズしたXSL-FOテンプレートを使用して、レポート問合せの作成およびレポート・リージョンの出力を含む基本的な出力機能が使用できるようになります。
Oracle BI Publisher: Oracle BI Publisher(Oracle XML Publisherとも呼ばれる)の使用許諾が必要です。このオプションによって、レポートの問合せ結果を取得し、Oracle BI Publisherを使用して、XMLからRTF形式に変換できるようになります。Application Express内でのレポート出力用に、独自にカスタマイズしたRTFまたはXSL-FOのテンプレートをアップロードする場合、このオプションを選択してください。
関連項目: Oracle BI Publisherのインストールおよび構成の詳細は、「PDF Printing in Application Express」を参照してください。次のWebサイトにアクセスしてください。 |
レポート出力の機能をすべて使用するには、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。
レポート・リージョンまたはレポート問合せを書式設定するには、レポート・レイアウトと関連付けます。詳細は、「レポート・レイアウトについて」を参照してください。
ヒント: また、アイテムによって出力結果を指定させることもできます(このようなアイテムは実行時に出力形式を決定します)。形式値を保持するアイテムを選択します。有効な値は、「PDF」、「RTF」(ドキュメントをMicrosoft Wordで開く)、「XLS」(ドキュメントをMicrosoft Excelで開く)および「HTM」(ドキュメントをHTMLファイルとしてダウンロードする)です。 |
レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれる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レイアウトのコピーを作成できます。
名前付き列: 名前付き列のレポート・レイアウトは、問合せ固有のレポート・レイアウトで、問合せ結果セットに含まれる列の定義済リストで使用できるよう設計されています。このレイアウト・タイプはページ・アイテムおよび問合せ列の位置を正確に制御する必要がある場合に、個別に設計されたレイアウトで使用されます。
「レポート・レイアウト」オプションの可用性は、サイト管理者がサイトでどのようなレポート出力設定を行ったかによって異なります。次のステップに示すすべてのオプションが使用可能であるとはかぎりません。
関連項目: Oracle Application Express管理ガイドの「レポート出力の構成」 |
レポート・レイアウトを作成するには、次のステップを実行します。
共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。
「レポート」の下の「レポート・レイアウト」をクリックします。
「作成」をクリックします。
レポート・レイアウトの作成ウィザードが表示されます。
「レポート・レイアウト・タイプ」で、オプションを選択し、「次へ」をクリックします。
汎用列(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変換を実行することが可能になります。
残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。
「変更の適用」をクリックします。