8.5.2 レガシー・コンポーネント・ビューでのクラシック・レポートの編集

開発者は、コンポーネント・ビューでクラシック・レポートを作成および編集できます。レポート属性ページを使用すると、開発者はクラシック・レポートのレポート・レイアウト、ページ区切り、列ソート、エラー・メッセージ、エクスポート・リンクおよび列ブレークを制御できます。

トピック:

関連項目:

「レガシー・コンポーネント・ビューでのページの管理」、「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および『Oracle Application Express APIリファレンス』のAPEX_IRに関する項

8.5.2.1 コンポーネント・ビューでのクラシック・レポート属性の編集

この項では、レポート属性を編集することによってクラシック・レポートをカスタマイズする方法について説明します。

レポート属性ページを表示するには、次のステップを実行します。

コンポーネント・ビューで、レポートを含むページを表示します。レガシー・コンポーネント・ビューでのページの表示

コンポーネント・ビューが表示されます。
レポート属性ページにアクセスするには、編集するレポート・リージョンの横にある「レポート」リンクをクリックします。

図GUID-11ADC3BC-DFCD-412F-91F5-22300E490A72-default.pngの説明

レポート属性ページが表示されます。このページは次のセクションに分かれています。
- 「列属性」はレポート・レイアウトを制御します。コンポーネント・ビューでのクラシック・レポート・レイアウトの変更を参照してください。
- 「レイアウトおよびページ区切り」属性はレポート・ページ区切りを制御します。コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御を参照してください。
- 「メッセージ」の属性を使用すると、データが見つからない場合、または表示できる以上のデータが見つかった場合に表示されるメッセージを定義できます。
- 「レポートのエクスポート」属性を使用すると、レポートにダウンロード・リンクを追加するか、レポートをXMLファイルまたはCSVファイルとしてエクスポートできます。コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加およびXMLファイルまたはCSVファイル・エクスポートのサポートの追加を参照してください。
- 「ブレーク書式」属性を使用すると、出力時に特定の列を繰り返すかどうか、および列をどのようにブレークするかを制御できます。コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御を参照してください。
- 「外部プロセス」属性を使用すると、後処理用のURLおよびリンク・ラベルを指定できます。
属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。
変更を保存するには、「変更の適用」をクリックします。

8.5.2.2 コンポーネント・ビューでのクラシック・レポート・レイアウトの変更

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、列の非表示化、列の合計の作成、またはソート順序の選択を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

ページ上部に「列属性」セクションがあるレポート属性ページが表示されます。

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー・タイプ」はレポートの見出しの生成方法を指定します。「リンク」列は列リンクが現在定義されているかどうかを示します。「編集」列は列が現在更新可能かどうかを示します。

表 8-12に、レポート列の基本的な編集操作を示します。

表 8-12 クラシック・レポートのレポート列の基本的な編集操作

説明	開発者アクション
列の表示順序を変更します。	上矢印および下矢印をクリックして、列の表示順序を変更します。
ヘッダーの位置合せを変更します。	「列の位置合せ」で、列の位置を選択します。
列ヘッダーのテキストを変更します。	「ヘッダー」で、異なるヘッダー・テキストを入力します。
表示する列を制御します。	「表示」をクリックして、列を表示させるようにします。
一意のソート順序を有効にします。	「ソート」をクリックし、「ソート順序」から順序番号を選択します。任意の数の列をソート可能にできます。ただし、1つ以上の列にソート順序が定義されている必要があります。
列の合計を有効にします。	「合計」をクリックして、列の合計を有効にします。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

列属性ページにアクセスするには、該当する列の別名の横にある「編集」アイコンをクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

8.5.2.3 コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御

この項では、クラシック・レポートでページ区切りを制御する方法について説明します。

トピック:

8.5.2.3.1 クラシック・レポートのページ区切り

クラシック・レポートで、レポート・ページ区切りを制御する方法を次に示します。

ページ区切り置換文字列をレポート・テンプレートに含める方法
レポート属性ページの「レイアウトおよびページ区切り」セクションから選択する方法

「レポート属性」ページの「レイアウトおよびページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

8.5.2.3.2 クラシック・レポートのページ区切りの制御

クラッシック・レポートのページ区切りを制御するには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。
「レイアウトおよびページ区切り」で、次の項目を選択します。
1. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。
2. ページ区切りスキーム: ページ区切りスキームを選択します。
3. 表示位置: 表示位置を選択します。
4. 行数: ページごとに表示する行数を指定します。
5. 「変更の適用」をクリックします。

プロパティ・エディタで、表8-13に示す属性を見つけて編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

表8-13 「レイアウトおよびページ区切り」属性

属性	説明
レポート・テンプレート	このレポートに適用するテンプレートを指定します。レポート・テンプレートによって、SQL問合せによって戻される1行の結果が制御されます。多数のデフォルトのテンプレートから選択するか、またはカスタム作成のテンプレートを選択できます。
レポート属性	`#REPORT_ATTRIBUTES#`置換文字列と置き換える値を入力します。`#REPORT_ATTRIBUTES#`置換文字列は、レポート・テンプレートの「行の前」属性でのみ置換されます。
NULL値を置き換えて表示	NULL列に表示するテキストを入力します。デフォルト値は`(null)`です。
ページ区切りスキーム	このレポートのページ区切りタイプを指定します。ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。また、次のページまたは前のページへのナビゲートに使用するリンクまたはボタンのスタイルも定義されます。
部分ページ・リフレッシュの有効化	この属性が有効な場合は、結果セットでページ区切りが前後に移動したときに、レポート・リージョンがリフレッシュされます。
表示位置	ページ区切りの表示位置を定義します。レポートの上にページ区切りを表示する場合は、選択したレポート・テンプレートで、このタイプの表示がサポートされている必要があります。
行数	ページごとに表示する最大行数を定義します。
行数(アイテム)	SQL問合せに対して、ページごとにデフォルトで表示する行数を定義します(アイテムから動的に取得されます)。この属性でアイテムを識別します。
行カウント最大値	問合せを行う最大行数を定義します(例: 456行中の行1 - 10)。この属性を200に設定すると、結果は次のように表示されます。 `rows 1 - 10 of more than 200 rows` この属性はパフォーマンスに影響を与えます。より少ない行数をカウントするとパフォーマンスは向上し、数千という行数をカウントするとパフォーマンスは低下します。
HTMLの削除	HTML式、列リンク、およびCSVファイルとしてエクスポートされたレポート・データに対して、元の列値からHTMLタグを削除するかどうか指定します。 HTMLタグが含まれているデータベースから値を選択すると、それらのタグが列リンクまたはHTML式用に生成されたHTMLと競合する可能性があります。このオプションを有効にすると、列値の実際のデータ部分のみが使用されます。
NULLのソート	ソートされた列ヘッダーを含むレポートの場合、最初または最後にソートするNULL値の列が必要かどうかを指定してください。関連項目: コンポーネント・ビューでのクラシック・レポートの列ソートの有効化

8.5.2.3.3 クラシック・レポート内での行の後へのページ区切りの挿入

レポート内の行の後にページ区切りを挿入するには、次のステップを実行します。

レポートを作成します。ページの作成ウィザードを使用したレポートの作成を参照してください。
クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。
「レイアウトおよびページ区切り」で、次を指定します。
1. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。
2. ページ区切りスキーム: ページ区切りスキームを選択します。
3. 表示位置: 表示位置を選択します。
4. 行数: ページごとに表示する行数を指定します。
5. 「変更の適用」をクリックします。
レポート・テンプレートを編集します。
1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。
2. 「テンプレート」で、レポート・テンプレート名を選択します。
3. 「行の後」属性に#PAGINATION#置換文字列を含めます。
4. 「変更の適用」をクリックします。
ページを実行します。

8.5.2.3.4 クラシック・レポート内での行の前へのページ区切りの挿入

レポート内の行の前にページ区切りを挿入するには、次のステップを実行します。

レポートを作成します。ページの作成ウィザードを使用したレポートの作成を参照してください。
クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。
「レイアウトおよびページ区切り」で、次のステップを実行します。
1. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。
2. ページ区切りスキーム: ページ区切りスキームを選択します。
3. 表示位置: topという語が使用されている位置を選択します。
4. 行数: ページごとに表示する行数を指定します。
5. 「変更の適用」をクリックします。
レポート・テンプレートを編集します。
1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。
2. 「テンプレート」で、レポート・テンプレート名を選択します。
3. 「行の前」属性に#TOP_PAGINATION#置換文字列を含めます。
4. 「変更の適用」をクリックします。
ページを実行します。

8.5.2.4 コンポーネント・ビューでのクラシック・レポートの列ソートの有効化

レポート属性ページで列ソートを有効にできます。

列ソートを有効にするには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。
「列属性」で、ソートする列の横にある「ソート」チェック・ボックスを選択します。
「ソート順序」から、順序番号を選択します。
「ソート順序」はオプションです。ただし、ソート可能な列が1列以上ある場合は、定義済のソート順序が1列以上で必要です。
「変更の適用」をクリックします。

ヒント:

レポートの最初および最後にNULL値を含む列を表示する場合は、列のソートを有効にする必要があります。

8.5.2.5 コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加

レポート内にリンクを作成して、ユーザーがレポートをカンマ区切りファイル(.csv)としてエクスポートできるようにします。CSVリンクをレポートに追加するには、CSV出力オプションを有効にする必要があります。CSV出力オプションを使用する際、レポート・テンプレートは重要ではありません。CSVリンクは、CSVエクスポート置換文字列が定義されていればどのレポート・テンプレートに追加することもできます。

関連項目:

自動CSVエンコーディング

8.5.2.6 コンポーネント・ビューでのクラシック・レポートのCSV出力の有効化

CSV出力の有効化オプションを使用するには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。
「レポートのエクスポート」までスクロールします。
「CSV出力の有効化」から、「はい」を選択します。
(オプション)「セパレータ」および「囲み文字」フィールドで、セパレータおよびデリミタを定義します。
デフォルトの囲み文字は、二重引用符(" ")です。デフォルトのデリミタは、カンマまたはセミコロンで、現在のNLS設定によって異なります。
「リンク・ラベル」で、リンク・テキストを入力します。このテキストは、レポート内に表示され、ユーザーはダウンロードを起動できます。
(オプション)デフォルトのエクスポート・ファイル名を指定するには、「ファイル名」フィールドに名前を入力します。
デフォルトでは、Application Expressエンジンによって、リージョン名が取得され、該当するファイル名の拡張子(.csvまたは.xml)が追加されて、エクスポート・ファイル名が作成されます。
「変更の適用」をクリックします。

8.5.2.7 XMLファイルまたはCSVファイル・エクスポートのサポートの追加

レポート・テンプレートを選択することで、XMLまたはCSVとしてレポートをエクスポートする操作のサポートを追加できます。

レポートをファイルとしてエクスポートするには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。
「レイアウトおよびページ区切り」までスクロールします。
「レポート・テンプレート」リストから、「エクスポート: XML」または「エクスポート: CSV」を選択します。
「エクスポート: XML」を選択すると、Application Expressエンジンでページがレンダリングされなくなり、コンテンツがXMLファイルにダンプされます。
「変更の適用」をクリックします。

8.5.2.8 コンポーネント・ビューでのクラシック・レポートの列リンクの作成

この項では、アプリケーション内の別のページまたはURLへの列リンクを作成する方法について説明します。

トピック:

8.5.2.8.1 別のページへの列リンクの作成

別のページへの列リンクを作成するには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。
「列属性」で、リンクを含む列を指定します。
列名の横にある「編集」アイコンをクリックします。

列属性ページが表示されます。
「列リンク」までスクロールします。
別のページへの列リンクを作成するには、次のステップを実行します。
1. 「ターゲット」で、「このアプリケーションのページ」を選択します。
2. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。
3. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。
4. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。
5. 「リクエスト」で、使用するリクエストを指定します。
6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。対話モード・レポートへのリンクの設定を参照してください。
7. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。
「変更の適用」をクリックします。

8.5.2.8.2 URLへの列リンクの作成

URLへの列リンクを作成するには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。
該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。

列属性ページが表示されます。
「列リンク」までスクロールします。
「列リンク」で、次のように指定します。
1. 「ターゲット」から「URL」を選択します。
2. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。
3. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。
4. 「URL」で、該当するアドレスを入力します。
「変更の適用」をクリックします。

8.5.2.9 コンポーネント・ビューでの更新可能な列の定義

列属性ページの「表形式フォームの要素」属性を編集することで更新可能な列を作成できます。Application Expressエンジンは、次の場合にのみ更新を実行できることに注意してください。

複数行の更新が定義されている場合
更新済データを処理するためにPL/SQLプロセスが実装されている場合
組込み表形式フォームの要素および表示タイプを使用している場合、レポートは、SQL問合せ(更新可能レポート)のタイプを使用して定義する必要があります。

更新可能な列属性を定義するには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。
該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。

列属性ページが表示されます。
「列属性」で、次のように指定します。
1. 表示形式: 更新可能な列の型を選択します。
  
  列を更新可能にするには、このオプションを使用します。更新は、複数行の更新が定義されている場合、または更新済データを処理するためにPL/SQLプロセスが実装されている場合にのみ実行できます。
2. 数値/日付書式: 「日付ピッカー」の「表示形式」タイプを選択している場合は選択を行います。
3. 要素の幅: フォーム・アイテムの幅を指定します。
4. 行数: テキスト領域に適応するフォーム・アイテムの高さを指定します。
5. 要素属性: スタイルまたは標準のフォーム要素属性を定義します。
6. 要素オプションの属性: ラジオ・グループまたはチェック・ボックス内のアイテムのフォーム要素属性を指定します。
「表形式フォームの属性」で、次のように指定します。
1. デフォルト・タイプ: デフォルトのタイプを指定します。
2. デフォルト: デフォルトのソースを指定します。
3. 参照表の所有者: 参照される表の所有者を指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。
4. 参照表名: 対象の列が参照する表またはビューを指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。
5. 参照列名: 対象のレポート列が参照する列名を指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。
「変更の適用」をクリックします。

8.5.2.10 コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義

列は、ラジオ・グループとしてレンダリングするか、静的LOV、名前付きLOVまたは問合せベースのLOVとしてレンダリングできます。たとえば、選択リストまたはポップアップLOVを使用して列をレンダリングできます。または、LOVに基づく読取り専用テキストとして列をレンダリングすることもできます。

この最後の方法は、表示参照値を作成する場合に効果的な手法であり、特に、更新できない通常のレポートで役立ちます。この方法を使用すると、SQL JOIN文を記述することなく、列の値を表示できます。

LOVとしてレポート列をレンダリングするには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。
該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。

列属性ページが表示されます。次に、列のレンダリング方法(ラジオ・グループ、LOV、選択リストなど)を指定します。
「列属性」で、「表示形式」リストから選択します。
「LOV」までスクロールします。
「名前付きLOV」で、LOVリポジトリから選択します。
LOVにNULL値を含めるには、次のステップを実行します。
1. NULLの表示: 「はい」を選択します。
2. NULL表示値: ここにNULLオプションの表示値を入力します。
3. NULL戻り値: 対象のアイテムのLOVに使用するNULL値を入力します。値を指定しなかった場合のデフォルトは%null%です。
また、列には、LOVで表示されない値を格納することもできます。
LOVで表示されない値を定義するには、次のステップを実行します。
1. 「追加値の表示」で、「はい」を選択します。
  
  追加値は、実際の列値がLOVの一部ではない場合に使用されます。このような場合は、実際の値が表示されます。追加値を表示しない場合は、誤った値になる可能性があり、データが不適切に自動更新されます。
2. 「NULL値」で、表示する値を指定します。
3. 名前付きLOVを選択していない場合は、「LOV問合せ」フィールドに選択リストを表示するための問合せを入力します。
名前付きLOVを選択していない場合、LOV定義に選択リストを表示するために使用する問合せを入力します。
「変更の適用」をクリックします。

8.5.2.11 コンポーネント・ビューでのクラシック・レポートの列の表示条件の制御

「認可」属性および「条件」属性を使用すると、列の表示条件を制御できます。

認可を使用すると、事前定義されたユーザー権限に基づいて(レポート列などの)リソースへのアクセスを制御できます。たとえば、マネージャのみが特定のレポート列を表示できる認可スキームを作成できます。認可スキームを選択するには、まずその認可スキームを作成する必要があります。

条件とは、事前定義された条件タイプに基づいた列の表示の制御を可能にする論理単位です。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseと評価されます。

認可属性および条件属性を指定するには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。
該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。
認可スキームで列を制御する場合は、「認可スキーム」リストから選択します。
条件で列を制御する場合は、条件を定義し、「条件タイプ」リストから選択します。選択に応じて、適切な「式」フィールドに式または値を入力します。
認可が正常に終了し、条件タイプの表示がtrueに評価されると、列が表示されます。

8.5.2.12 コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御

ブレーク書式属性を使用すると、出力する場合に、特定の列を繰り返すかどうか、および列のブレーク方法を制御できます。たとえば、レポートに、部門番号ごとに従業員情報を表示するとします。複数の従業員が同じ部門に所属している場合、部門番号が1回のみ表示されるように指定することによって、読みやすさを向上できます。

このタイプの列ブレークを作成するには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。
「ブレーク書式」までスクロールします。
「ブレーク」リストから選択します。

8.5.2.13 クラシック・レポートの列の順序とリージョン・ソースの同期

クラシック・レポートの列の順序を、リージョン・ソースの問合せで定義された列の順序と同期化するには、次のステップを実行します。

クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。
「タスク」から、「列の順序とリージョン・ソースの同期化」を選択します。
「同期化」をクリックします。