レポート出力の構成

レポート・レイアウトの概要

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

Application Expressでは、レポート・レイアウトを作成して使用する際に、多くの柔軟性が用意されています。

• ユーザーは、Application Expressで提供されているデフォルトのレイアウト（レポート・リージョンの場合）や汎用レイアウト（レポート問合せの場合）を使用できます。

• 組込みのXSL-FOベースのレポート・リージョンのレイアウトを使用して、コードをコピーおよびカスタマイズできます。ページ・サイズやフォント、色などを制御する様々なレポート・リージョンの属性を編集できます。

• RTFまたはXSL-FOレポート・レイアウトを作成してレポートのルック・アンド・フィールをカスタマイズできます。RTFレポート・レイアウトを使用するには、Oracle Application Expressのサービス管理者はサイトで詳細設定を選択する必要があります。

レポート問合せの作成

「レポート問合せ」オプションの可用性は、サービス管理者がサイトでどのようなレポート出力設定を行ったかによって異なります。これらのステップに示されたすべてのオプションが使用可能であるとはかぎりません。

レポート問合せを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」で、「レポート問合せ」をクリックします。

3. 「作成」をクリックします。

4. 問合せを実行するには、次の情報を指定します。

   1. 名前: レポート問合せの名前を入力します。

      この名前は、レポート問合せのダウンロードに使用するURLのリクエスト文字列の一部です。

   2. SQL問合せ: SQL文を直接入力するか、「クエリー・ビルダー」をクリックして、クリックやポイントによってSQL文を作成します。

      SQL文でアプリケーションおよびページ・アイテムを参照するには、バインド変数として参照します。

   3. 「次へ」をクリックします。

5. 問合せをテストするには、「問合せのテスト」をクリックします。レポート問合せをテストすることで、適切な結果セットが戻されるかどうか確認できます。

   バインド変数を含めると、問合せを実行する前にテスト値を設定できます。テスト値は、レポート問合せのXML構造のエクスポート時、および形式が設定されたテスト・バージョンのレポート問合せのダウンロード時に、このウィザードの後のステップでも使用されます。

6. 問合せのテスト後に、「次へ」をクリックします。

7. （オプション）「セッション・ステートを含む」で、次を指定します。

   1. セッション・ステートを含めるには、上矢印をクリックしてリストからアイテムを選択します。

      セッション・ステート・アイテムを使用してレポートとともに追加データを表示します。たとえば、顧客の住所を表示するアイテムを選択して、注文フォームにその情報を表示できます。注文のヘッダー情報は注文の詳細とともに表示されます。

   2. 「追加」をクリックしてアイテムをボックスに移動します。

   3. 「次へ」をクリックします。

8. 「XMLのダウンロード」で、画面に表示される手順に従います。

9. 「確認」で、次のステップを実行します。

   1. 問合せ名: 問合せを識別します。

   2. レポート・レイアウト: 選択したレポート・レイアウトを識別します。

   3. 出力形式: このレポート問合せの形式を選択します。

   4. （オプション）アイテム: 形式情報を保持するアイテムを選択します。

   5. URL: このレポートをアプリケーションに統合するには、表示されたURLをボタン、リスト・アイテム、リンクまたは他のナビゲーション・コンポーネントに対するターゲットとして使用します。これにより、たとえば、エンド・ユーザーはボタンをクリックして、出力プロセスを開始できます。

   6. テスト・レポート: これをクリックしてレポートをプレビューします。

   7. 「終了」をクリックします。

      レポート問合せは、「共有コンポーネント」に作成および保存されます。

レポート・レイアウトの作成

レポート・レイアウトを作成して、問合せまたはレポート・リージョンにレポートを関連付けます。次のオプションのいずれかに基づいて、新しいレポート・レイアウトを作成できます。

• 汎用列: 汎用レポート・レイアウトはほとんどの問合せ結果セットに使用できます。このレイアウトを使用すると、出力可能なドキュメントの生成時に、列の数が自動的に調整されます。

  多くのレポート・レイアウト属性は、組込みのデフォルトXSL-FOレイアウトを使用して、レポート・リージョンに対して宣言的に定義できます。レポート・レイアウトを追加制御する必要がある場合は、このステップによりカスタマイズ可能な組込みのデフォルトXSL-FOレイアウトのコピーを作成できます。

• 名前付き列: 名前付き列のレポート・レイアウトは、問合せ固有のレポート・レイアウトで、問合せ結果セットに含まれる列の定義済リストで使用できるよう設計されています。このレイアウト・タイプはページ・アイテムおよび問合せ列の位置を正確に制御する必要がある場合に、個別に設計されたレイアウトで使用されます。

「レポート・レイアウト」オプションの可用性は、サービス管理者がサイトでどのようなレポート出力設定を行ったかによって異なります。これらのステップに示されたすべてのオプションが使用可能であるとはかぎりません。

レポート・レイアウトを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」で、「レポート・レイアウト」をクリックします。

3. 「作成」をクリックします。

   レポート・レイアウトの作成ウィザードが表示されます。

4. 「レイアウト・タイプ」で、オプションを選択し、「次へ」をクリックします。

   • 汎用列(XSL-FO): このレイアウトは、デフォルトのテンプレートに事前移入され、ユーザーのニーズに合せて編集可能です。

   • 名前付き列(RTF): このレイアウトはRTFファイルとしてアップロードされます。

   • 名前付き列(XSL-FO): このレイアウトはXSL-FOファイルとしてアップロードされます。

5. 「レイアウト・ソース」で、該当する情報を確認および編集します。このページに表示されるオプションは、選択したレイアウト・タイプによって異なります。

   • 「汎用列」を選択した場合は、次のステップを実行します。

   1. レポート・レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際にレポート・レイアウトを識別するための名前を入力します。

   2. レポート・レイアウト: レポート・レイアウトは、ページ書式のXSL-FOベースの定義です。ページ・サイズ、向き、フォント、スタイルなどを定義する属性は、すべてこのセクションで定義されます。

      有効な置換文字列のリストおよびその他の情報のリストを表示するには、アイテム・ラベル「レポート・レイアウト」をクリックします。個別のヘルプ・ウィンドウが開きます。

   3. レポートの列ヘッダー: レポート・ヘッダー行の各セルの外観を定義します。

   4. レポート列: すべてのレポート行に対する各セルの外観を定義します。

   5. レポート列の幅: 実行時に計算されるか、またはレポート・リージョンのレポート列定義から導出できます。

   • 名前付き列を選択した場合は、次のステップを実行します。

   1. レポート・レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際にレポート・レイアウトを識別するための名前を入力します。

   2. レポート・レイアウトを含むファイルをアップロードします。

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

サポートされている形式でレポート・リージョンをダウンロードまたは出力するには、次の一般的なステップを実行する必要があります。

1. 設定するレポート・リージョンを含むページを選択します。

2. レポート・タイプのリージョンを作成または選択します。

   レポートに表示される結果の標準のSQL問合せに基づいたレポート問合せは、このリージョンに関連付けられている必要があります。

3. そのリージョンのレポート出力を有効にします。

   このオプションは必ず選択してください。このタスクの残りのステップで、デフォルトを受け入れるか、別のオプションを選択できます。

4. 出力形式を選択します。

5. レポート・レイアウトをレポート・リージョンに関連付けます。

   デフォルトのレポート・レイアウトには、レポートに表示される「出力」リンクが含まれます。これはカスタム・ボタンと置換可能です。

6. 用紙サイズ、向き、ヘッダーおよびフッターなどの他の出力属性を設定します。

   デフォルトのレポート・レイアウトを使用する場合、エンド・ユーザーは「出力」ボタンをクリックして出力プロセスを開始します。

レポート・リージョンの出力属性の構成

出力機能がサイトで設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

出力用にレポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力するレポート・リージョンを含むページを選択します。

   ページ定義が表示されます。

2. 「リージョン」で、出力するリージョンの横にある「レポート」をクリックします。

3. 「出力属性」タブをクリックします。

4. 「出力」で、次の該当する情報を指定します。

   • レポート出力の有効化: 「はい」を選択します。

   • リンク・ラベル: 出力プロセスを開始するリンクのテキストを入力します。

   • （オプション）ファイル名: ダウンロードされるファイルの名前を入力してください。空白にすると、リージョン名がファイル名として使用されます。

   • 出力形式: 出力オプションを選択します。

   • アイテム: 「ページ・アイテムから派生」を選択する場合は、アイテムを選択します。

   • レポート・レイアウト: 「デフォルト・レポート・レイアウト」またはユーザーまたは管理者が作成した使用可能なレポート・レイアウトを選択します。

5. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

6. 「変更の適用」をクリックします。

デフォルトのテンプレートを使用した場合、エンド・ユーザーは「出力」リンクをクリックすると、このリージョンで指定された書式でレポートを出力できます。