8.9.7 対話モード・レポートの列属性の管理

列属性を編集すると、対話モード・レポート列の表示、機能および動作を制御できます。

• 対話モード・レポートの列属性の編集
  列属性を編集して、レポート・レイアウトを詳細に制御します。
• 対話モード・レポートでの列リンクの作成
  レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を構成します
• 対話モード・レポートでのLOVとしての列定義
  対話モード・レポートに、LOVを追加して組込みフィルタ・ツールの速度を向上させます。
• 対話モード・レポートでの列の書式設定
  HTML式を使用して列の表示をカスタマイズします。
• 対話モード・レポートの列での条件付きリンクのフィルタ処理について
  対話モード・レポートの列での条件付きリンクのフィルタ処理について説明します。

関連項目:

ページ・デザイナでのページの編集

8.9.7.1 対話モード・レポートの列属性の編集

列属性を編集して、レポート・レイアウトを詳細に制御します。

これらの属性を使用して、列ヘッダーの変更、列の位置の変更、列の非表示化またはユーザーが列を操作できる方法の制御を行います。

列属性を編集するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
   「レンダリング」タブに列が表示されます。
3. 編集する列を選択します。
   プロパティ・エディタにその列の属性が表示されます。属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択できます。
4. 対象となる属性を編集します。

   属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 識別、タイプ - 関連する列の表示タイプを選択して、列値の表示方法を定義します。列の表示タイプについてさらに学習するには、プロパティ・エディタで「タイプ」属性を選択し、中央ペインで「ヘルプ」タブをクリックします。
6. ヘッダー - 使用可能な属性は次のとおりです:
   1. ヘッダー、ヘッダー - レポートの列ヘッダーのテキストを入力します。
   2. ヘッダー、代替ラベル - ダイアログおよび様々な列ヘッダーの配置で使用する代替ラベルを入力します。ヘッダーにHTMLタグなどの正しく表示されない余分な書式設定が含まれる場合に代替ラベルを使用します。
   3. ヘッダー、位置合せ - ヘッダーの位置合せを選択します。位置合せの選択は、選択したレポート・テンプレートでサポートされている必要があることに注意してください。

      使用可能なオプションは次のとおりです。

      • 開始
      • 中央
      • 終了
7. ユーザーの有効化 - ユーザーが列を操作する方法を制御します。それぞれの属性について、「オン」または「オフ」を選択します

   属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

8. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

対話モード・レポートの列での条件付きリンクのフィルタ処理についておよびページ・デザイナの右ペイン(プロパティ・エディタ)

8.9.7.2 対話モード・レポートでの列 リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を構成します

別のページへの列リンクを作成するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
   「レンダリング」タブに列が表示されます。
3. 編集する列を選択します。
   プロパティ・エディタにその列の属性が表示されます。属性は、グループに編成されます。
4. 「識別」を検索します。「タイプ」から、「リンク」を選択します
5. 「リンク」を検索して、「リンクが定義されていません」をクリックします。
   「リンク・ビルダー - ターゲット」ダイアログが表示されます。
6. 別のページへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで:
   1. タイプ - 「このアプリケーションのページ」を選択します。
   2. ページ - ターゲット・ページ番号を指定します。
   3. アイテムの設定 - 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。
   4. 「クリア/リセット」の「キャッシュのクリア」 - キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。
   5. 「クリア/リセット」の「アクション」 - 次のいずれかを選択します。

      • なし - ページのロード時にアクションはクリア/リセットされません。

      • リージョンのクリア - ページのリージョン設定をすべてクリアします。

      • リージョンのリセット - ソート順序、非表示の列などを含め、ページのすべてのリージョンをデフォルトの状態にリセットします。

      • ページ区切りのリセット - このオプションでは、下位互換性が有効になります。

   6. 詳細、リクエスト - 使用するリクエストを指定します。
   7. 「OK」をクリックします。
7. URLへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで:
   1. タイプ - 「URL」を選択します。
   2. URL - URLアドレスを入力します。
   3. 「OK」をクリックします。
8. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.9.7.3 対話モード・レポートでのLOVとしての列定義

対話モード・レポートに、値リストを追加して組込みフィルタ・ツールの速度を向上させます。

レポート列をLOVとして定義するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。
3. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
   「レンダリング」タブに列が表示されます。
4. 編集する列を選択します。
5. 列フィルタを構成します。
   1. 「列フィルタ」を検索します。
   2. 「タイプ」で、レポート列ドロップ・ダウン・リストに表示されるフィルタの導出方法を選択します。オプションは次のとおりです。

      • なし - 列フィルタは、このレポートに指定されません。

      • 列タイプに基づくデフォルト - STRINGおよびNUMBERの列では固有の列値からLOVを導出します。DATE列では、事前定義された日付範囲からLOVを導出します。

      • 完全一致のフィルタ処理に定義済LOVを使用 - 定義済LOVのSQL問合せからLOVを導出してequalフィルタを作成します。

      • 「単語を含む」のフィルタ処理に定義済LOVを使用 - 定義済LOVのSQL問合せからLOVを導出してcontainsフィルタを作成します。

      • 完全一致のフィルタ処理に名前付きLOVを使用 - 名前付きLOVからLOVを導出してequalフィルタを作成します。

      • 「単語を含む」のフィルタ処理に名前付きLOVを使用 - 名前付きLOVからLOVを導出してcontainsフィルタを作成します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.9.7.4 対話モード・レポートでの列の書式設定

HTML式を使用して列の表示をカスタマイズします。

列の書式設定を定義するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
   「レンダリング」タブに列が表示されます。
3. 編集する列を選択します。
4. 列の書式を構成します。
   1. 「列の書式」を検索します。
   2. 「HTML式」で、この列に表示するHTML式を入力します。HTMLで列値を示すには、#COLUMN#構文を使用します。

      • 例1: 背景およびテキストの色の変更

        <span style="background-color: yellow; color: red;">#EMPLOYEE_STATUS#</span>
        

      • 例2: ヘッダー2の使用

        <h2>#EMPLOYEE_NAME#</h2>
        

      • 例3: SQL問合せからの動的クラスの使用

        <span class="#COLUMN_CLASS#">#EMPLOYEE_STATUS#</span>

        この例で#COLUMN_CLASS#および#EMPLOYEE_STATUS#に代入されるのは、レポートSQL問合せで選択された列です。

      • 例4: イメージの表示およびカーソルをあわせたときのツールチップの表示

        <img src="#IMAGE_NAME#" alt="#EMPLOYEE_NAME#" title="#EMPLOYEE_NAME#">

        次に、テンプレート・ディレクティブの使用例を2つ示します。詳細は、「テンプレート・ディレクティブの使用」を参照してください。

      • 例5: カンマ区切りのLOVのループ

        <ul>{loop "," TAGS/}<li>&APEX$ITEM.</li>{endloop/}</ul>

      • 例6: 引用符で囲まれた識別子を持つ列に対する"if"ディレクティブの使用

        {if Mixed Case Name/}<strong>#"Mixed Case Name"#</strong>{endif/}

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.9.7.5 対話モード・レポートの列での条件付きリンクのフィルタ処理について

対話モード・レポートの列での条件付きリンクのフィルタ処理について説明します。

対話モード・レポートにリンクである列値があり、かつ、レポート問合せにリンク・マークアップが構成されている場合は、列ヘッダー・メニューからこの値に対するフィルタを定義しようとすると、失敗します。Oracle APEXでは列ヘッダー・メニューでリンクを正しくレンダリングできません。これは、列値自体が、フィルタの適用先として選択できるように、リンクとしてレンダリングされるためです。開発者が問合せロジックに基づいて条件付きでリンクをレンダリングする必要がある場合に、そのリンクが、宣言的列リンク・サポートを使用しないで、レポート問合せで定義されていることがあります。

列の条件付きリンクに対するフィルタ処理を機能させるために、開発者には次の2つのオプションがあります。

• オプション1: HTML式列を使用します。
  1. リンクからリンク・テキストと同等のテキストを選択する問合せに別の列を追加し、my_link_displayの列の別名を定義します。この列の別名は、列ヘッダー・メニューで使用される値になります。
  2. my_link列を「非表示」タイプに変更します。
  3. my_link_display列で、列ヘッダーをmy_link列と同じに設定し、「HTML式」を#MY_LINK#に設定します。デフォルトの「特殊文字をエスケープ」を「はい」のままにします。

  4. ページを実行します。

     必要に応じて、列の順序を変更して、新しい列が古い列と同じ位置になるようにします。「アクション」メニューを選択し、「列の選択」を選択します。

  5. 新しいデフォルト・レポートを保存します。「アクション」メニューを選択し、「レポートの保存」、デフォルトのレポート設定として保存の順に選択します。

  リンクはレポートで適切にレンダリングされ、フィルタを正しく設定するmy_link_display値が列ヘッダー・メニューでレンダリングされるようになりました。

• オプション2: リンク・テキストに対して問い合せることができるリンク列にカスタム列フィルタを使用します。

関連項目:

対話モード・レポートの列属性の編集