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

レポート問合せの定義によって、レポート・リージョンを印刷します。

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

レポート問合せについて説明します。

Oracle APEXにおいて、レポート問合せとは、レポートに表示されるデータをフェッチするために使用されるSQL問合せのことです。データ・ソースは、表、SQL問合せまたはRESTデータ・ソースです。レポート問合せでは、レポートに含める列、データ・ソース、およびデータに適用する条件やソートを定義します。レポート問合せは、SQL文である必要があります。SQL文を戻すファンクションはサポートされていません。

レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。

レポート問合せを書式設定されたドキュメントとしてダウンロードするには、レポート・レイアウトと関連付けます。レポート・レイアウトを選択しなかった場合、APEXでは汎用レイアウトが使用されます。汎用レイアウトを使用して、レポート問合せをテストおよび検証できます。汎用レイアウト・オプションを使用する場合にソース問合せが複数定義されていると、最初の結果セットのみが出力ドキュメントに含まれます。レポートには、現行のアプリケーションのセッション・ステートを含めることができます。

次のプリント・サーバー・タイプは汎用レポート・レイアウトをサポートしていません:

  • Oracle Document Generator事前構築済ファンクション
  • APEX Office Print

これらのレポートをユーザーが使用できるようにするには、アプリケーションと統合します。たとえば、ボタン、リスト・アイテム、ブランチ、またはターゲットとしてURLを使用できるその他のナビゲーション・コンポーネントをレポート問合せに関連付けることができます。そのアイテムを選択すると、出力プロセスが開始します。

16.15.2 レポート問合せの作成

共有コンポーネントでレポート問合せを作成します。

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

レポート問合せを作成するには:

  1. 共有コンポーネント・ページにナビゲートします。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
    2. アプリケーションを選択します。
    3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

      共有コンポーネント・ページが表示されます。

  2. 「ファイルとレポート」で、「レポート問合せ」をクリックします。
  3. 「作成」をクリックします。
  4. 「レポート問合せの作成」で、次のように指定します:
    1. レポート問合せ名 - レポート問合せを識別する名前を入力します。リンク・ターゲットとしてレポート問合せを参照する際に、レポート問合せ名はリクエスト文字列の一部になります。
    2. レポート・レイアウト - レポート・レイアウトを選択します。レポート・レイアウトをまだ作成していない場合は、後で指定できます。
    3. 「次」をクリックします。
  5. 「レポート問合せの定義」で、次のように指定します:
    1. 出力形式 - レポート出力形式を選択します。有効なオプションは次のとおりです。
      • アイテムから導出 - 実行時にアイテムから出力形式が導出されます。
      • PDF - Adobe Portable Document Format。
      • Word - Microsoft Word Rich Text Format。
      • Excel - Microsoft Excel形式。
      • HTML
      • XML - Extensible Markup Language。
      プリント・サーバー・タイプによっては、その他のオプションを使用できる場合があります。たとえば、AOPでは、「Powerpoint」、「Markdown」、「CSV」、「OpenDocumentテキスト」、「OpenDocumentスプレッドシート」および「OpenDocumentプレゼンテーション」もサポートされています。ドキュメント・ジェネレータについては、サポートされている出力形式は「PDF」のみです。
    2. (オプション)アイテム - 「アイテムから導出」を使用する場合は、実行時に出力形式を決定するアイテムを選択します。
    3. ファイルの表示形式 - レポート問合せドキュメントをWebブラウザでどのように開くかを選択します:
      • 添付 - ユーザーがレポート問合せのダウンロード・ボタンをクリックすると、ファイルを開くか、または保存するかを尋ねるダイアログ・ボックスが表示されます。
      • インライン - レポート問合せドキュメントをブラウザのウィンドウ内に表示します。
    4. アプリケーションとセッションの情報を含める - レポート問合せの出力でセッション・ステート値(ページ・アイテムの値など)を参照するには、このオプションを有効にします。
    5. 「次」をクリックします。
  6. 「レポート問合せのソース」で、ソースを選択します:
    1. ローカル・データベース - データはローカル・データベースをソースとします。
    2. REST対応SQLサービス - データは、REST対応SQLを使用して接続が定義されるリモート・データベースをソースとします。REST対応SQL参照を作成または保守するには、「共有コンポーネント」、「REST対応SQL」の順にナビゲートします。
    3. RESTデータ・ソース - データは、RESTデータ・ソースを使用して定義されるRESTful Webサービスをソースとします。RESTデータ・ソースを作成または保守するには、「共有コンポーネント」、「RESTデータ・ソース」.に移動します
    UIは、選択したデータ・ソースに応じて変わります。
  7. 残りのオプションを設定します。たとえば、前のステップで「ローカル・データベース」を選択した場合は、次のように設定します:
    1. ソース・タイプ - ソース・タイプを指定します。たとえば、「表」を選択します。
    2. 表/ビューの所有者 - 作成している検索構成の基になる表の所有者を選択します。
    3. 表/ビューの名前 - 検索構成の基になる表またはビューを選択します。
  8. 「次」をクリックします。
  9. (オプション)「問合せの追加」をクリックして、ソース問合せを追加します。
  10. 「次」をクリックします。
  11. 「確認」に次の情報が表示されます。
    1. 問合せ名 - 問合せを識別します。
    2. レポート・レイアウト - 選択したレポート・レイアウトを識別します。
    3. 出力形式 - このレポート問合せの形式を識別します。
    4. アイテムから導出 - 形式情報を保持するアイテムを識別します。
    5. URL - レポート問合せは、ボタン、ナビゲーション・リスト・エントリ、リスト・アイテムまたはその他のあらゆるリンク・タイプに対してターゲットとして示されるURLを使用して、アプリケーションと統合できます。「URL」フィールドをクリックすると、URLをコピーできます。
  12. 「作成」をクリックします。
    レポート問合せは、「共有コンポーネント」に作成および保存されます。

16.15.3 レポート問合せの編集

共有コンポーネントでレポート問合せを編集します。

レポート問合せを編集するには:

  1. 共有コンポーネント・ページにナビゲートします。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
    2. アプリケーションを選択します。
    3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

      共有コンポーネント・ページが表示されます。

  2. 「ファイルとレポート」で、「レポート問合せ」をクリックします。
  3. 目的のレポート問合せを選択します。
  4. 編集ページで、該当する属性を編集します。
  5. 「変更の適用」をクリックします。

16.15.4 レポート問合せのコピー

共有コンポーネントでレポート問合せをコピーします。

レポート問合せをコピーするには:

  1. 共有コンポーネント・ページにナビゲートします。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
    2. アプリケーションを選択します。
    3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

      共有コンポーネント・ページが表示されます。

  2. 「ファイルとレポート」で、「レポート問合せ」をクリックします。
  3. レポート問合せページで、「コピー」をクリックします。
  4. 「レポート問合せのコピー」で、コピーする問合せを選択して、レポート問合せの名前を入力し、「コピー」をクリックします。

    コピーが問合せリストに表示されます。

16.15.5 レポート問合せの使用状況の表示

「レポート問合せの使用状況」レポートを表示します。

「レポート問合せの使用状況」レポートを表示するには:

  1. 「レポート問合せ」ページにナビゲートします:
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
    2. アプリケーションを選択します。
    3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
    4. 「ファイルとレポート」で、「レポート問合せ」を選択します。
  2. 「レポート問合せ」ページで、「使用状況」をクリックします。
    「使用状況」ページに、現在のアプリケーションで選択したレポート問合せを出力するページ・プロセスおよび動的アクションが表示されます。

16.15.6 レポート問合せの履歴の表示

「レポート問合せ履歴」レポートを表示します。

「レポート問合せ履歴」レポートを表示するには:

  1. 「レポート問合せ」ページにナビゲートします:
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
    2. アプリケーションを選択します。
    3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
    4. 「ファイルとレポート」で、「レポート問合せ」を選択します。
  2. 「レポート問合せ」ページで、「履歴」をクリックします。
    「履歴」ページに、現在のワークスペースのレポート問合せへの最近の変更が表示されます。