9.5.2 対話グリッド属性の管理

レポート属性により、対話グリッドがどのように動作するかを制御します。開発者は、対話グリッド属性を編集して、エンド・ユーザーが基礎となるデータの編集、レポートのページ区切りの構成、エラー・メッセージの作成、ツールバーおよびダウンロード・オプションの構成、ユーザーがパブリック・レポートを保存できるかどうかの制御、およびアイコン・ビューと詳細ビューの追加を行えるかどうかを制御します。

• 対話グリッド属性の編集
  
• 既存の対話グリッドを編集可能にする
  
• 対話グリッドのページ区切りの制御
  
• 対話グリッド・ツールバーのカスタマイズ
  
• ユーザーが対話グリッドでパブリック・レポートを保存できるようにする
  
• パブリック・レポートを保存できるユーザーの制限
  
• 対話グリッドでのアイコン・ビューの有効化
  
• 対話グリッドでの詳細ビューの有効化
  

関連項目:

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

9.5.2.1 対話グリッド属性の編集

対話グリッド属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。

   ヒント:

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択できます。

4. 対象となる属性を編集します。

   ヒント:

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

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

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

9.5.2.2 既存の対話グリッドを編集可能にする

エンド・ユーザーは、列メニューおよびソート・オプションを使用してレポート・レイアウトを変更したり、ドラッグ・アンド・ドロップで列を再配置したり、「アクション」メニューのオプションを使用してデータの表示方法を変更することができます。ただし、開発者は、基礎となるデータが読取り専用であるか編集可能であるかをユーザーごとに決定します。対話グリッドが編集可能である場合、エンド・ユーザーは基礎となるデータを編集したり、行を追加、削除およびリフレッシュすることができます。編集可能対話グリッドには、ツールバーにデフォルトで「保存」ボタンが含まれます。開発者は決定できます

対話グリッドを編集可能にするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択できます。

   ヒント:

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

4. プロパティ・エディタで、「編集」を検索し、次の属性を更新します。
   1. 編集: 「はい」を選択します。
      「はい」を選択すると、レコードを処理するプロセスが自動的に作成されます。「有効」が「はい」に設定されている場合、追加のオプションが表示されます。
   2. 実行可能な操作: サポートされているデータ操作を選択します。オプションには、「行の追加」、「行の更新」、「行の削除」があります
   3. 許可された行操作列: 列値が行を更新または削除できるかどうかを示す列を選択します。
   4. 失われた更新タイプ: 失われた更新に対してデータを保護する方法を選択します。

      失われた更新は、2人以上のユーザーが同じデータを更新しようとしたときに、前のユーザーが行った更新が最後の更新によって上書きされる場合に発生します。このことを防ぐために、更新ではデータベース内の既存の列値と、レコードが最初に問い合されたときに取得された値をチェックできます。例は、ページ・デザイナのヘルプを参照してください。

      • 行の値: データを最初に問い合せる場合、チェックサム値が計算されます。チェックサムは、すべての更新可能な列を文字列に連結し、一意の値を生成して計算されます。更新されたレコードをコミットすると、このチェックサムがチェックサム値と比較されます。

      • 行バージョン列: データベース表にデータベース・トリガー(可能な場合)によってレコードが更新されるたびに増える列が含まれている場合、チェックサムを計算するかわりにこの列を使用できます。対話グリッドで複数の表のデータを更新する場合、このオプションはお薦めしません。

   5. 空の場合に行を追加: 対話グリッドに現在戻されるレコードがない場合に新しい行を追加するかどうかを指定します。有効にした場合、少なくとも1つのレコードが常に表示されるため、No Data Foundメッセージは表示されません。追加されたレコードは、更新されなかった場合、リージョンが保存されるときに挿入されません。
5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

9.5.2.3 対話グリッドのページ区切りの制御

ページ区切りによって、結果セット内の表示される行数および現在の位置に関する情報が提供されます。

対話グリッドのページ区切りを変更するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。

   ヒント:

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択します。

4. 「ページ区切り」を検索します。

   ページ区切り属性によって、結果セット内の表示される行数および現在の位置に関する情報が提供されます。

   ヒント:

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

5. 「ページ区切り」で、次の属性を編集します。
   1. タイプ: オプションを選択します。

      • ページ - 「アクション」メニュー、「書式」、「ページごとの行数」オプションでの選択に基づいて行が表示されます。追加の行がある場合、レポート・フッターにコントロールが追加され、ユーザーは行セット間を前後にナビゲートできるようになります。

      • スクロール: 対話グリッドの高さを埋める行が表示されます。エンド・ユーザーがスクロールすると、必要に応じて追加の行が表示されます。

   2. 総行数の表示: 「はい」または「いいえ」を選択します。
      「はい」を選択すると、レポート・フッターに総行数が表示されます。このオプションを有効にすると、追加の問合せが必要となり、非常に大きいデータ・セットのパフォーマンスが妨げられる場合があります
6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:

対話グリッドのページ区切りの例を確認するには、サンプル・アプリケーションのサンプル対話グリッドをインストールします。パッケージ・アプリケーションのインストールを参照してください。

9.5.2.4 対話グリッド・ツールバーのカスタマイズ

すべての対話グリッドは、ページの上部にツールバーがあります。開発者は、ツールバーにどのコントロールが表示されるかカスタマイズしたり、ツールバーを削除できます。

注意:

この手順で説明するオプションの中には、対話グリッドが編集可能である場合にのみ適用されるものがあります。既存の対話グリッドを編集可能にするを参照してください。

対話グリッド・ツールバーをカスタマイズするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。

   ヒント:

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択します。

4. プロパティ・エディタで、「ツールバー」グループを検索し、次のステップを実行します。
   1. 「表示」で、「はい」または「いいえ」を選択して、レポートの上部にツールバーを表示するかどうかを決定します。
   2. 「ボタン」で、ツールバーに表示されるボタンを選択します。

      オプションは次のとおりです。

      • リセット: 「リセット」では、すべてのカスタマイズ(フィルタ、列幅、並替えなど)が削除され、サーバーからレポート定義がリロードされます。

      • 保存 - 「保存」は、対話グリッドが編集可能で、かつ、エンド・ユーザーに追加、更新または削除する権限がある場合にのみ機能します。保存では、ページ全体を保存せずに、対話グリッドに行われた変更のみが保存されます。

   3. 「追加ボタン・ラベル」は、対話グリッドが編集可能である場合にのみ表示されます。「追加ボタンラベル」では、「追加」ボタンの代替ラベルを入力します。デフォルト・ラベルは、「行の追加」です。
5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:

ツールバー・ボタンの追加例を表示するには、サンプル・アプリケーションのサンプル対話グリッドをインストールして、レポート、ツールバー・ボタンの追加に移動します。パッケージ・アプリケーションのインストールを参照してください。

9.5.2.5 ユーザーが対話グリッドでパブリック・レポートを保存できるようにする

開発者がその機能を有効にした場合、ユーザーは対話グリッドをパブリック・レポートとして保存できます。パブリック・レポートはツールバーの「保存されたレポート」リストに表示され、すべてのユーザーが使用できます。ただし、パブリック・レポートを作成したユーザーのみが、そのレポートの保存、名前の変更または削除を行うことができます。

ヒント:

「パブリック・レポートの保存」属性は、認証されたユーザーのみが使用でき、定義済の認可スキームによってさらに制限されます。パブリック・レポートを保存できるユーザーの制限を参照してください。

エンド・ユーザーがパブリック・レポートを保存できるようにするには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。

   ヒント:

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択できます。

4. Property Editorで、次のように操作します。
   1. 「ユーザーの有効化」を検索します。
   2. パブリック・レポートの保存: 「はい」を選択します
5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

9.5.2.6 パブリック・レポートを保存できるユーザーの制限

開発者は認可スキームを選択して、パブリック・レポートを保存できるユーザーを制限できます。エンド・ユーザーがパブリック・レポートを保存できるようにするには、この認可スキームがそのユーザーに対してTRUEと評価される必要があります。認可スキームを選択しない場合、すべてのユーザーがパブリック・レポートを保存できます。

パブリック・レポートを保存できるユーザーを制限するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。

   ヒント:

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択します。

4. Property Editorで、次のように操作します。
   1. 「ユーザーの有効化」を検索します。
   2. パブリック・レポートの保存: 「はい」を選択します
   3. パブリック・レポートの保存の認可: 認可スキームを選択します。

      認可スキームを選択して、パブリック・レポート定義を保存できるユーザーを制限します。エンド・ユーザーがパブリック・レポートを保存できるようにするには、この認可スキームがそのユーザーに対してTRUEと評価される必要があります。認可スキームを選択しない場合、すべてのユーザーがパブリック・レポートを保存できます。

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

9.5.2.7 対話グリッドでのアイコン・ビューの有効化

対話グリッドはデータの様々なビューをサポートしています。デフォルトで、対話グリッドではグリッド・ビューにデータが表示されます。開発者は、必要に応じてデータをアイコンとして表示できます。アイコン・ビューを有効にすると、アイコン・ボタンがビュー選択ボタン・グループに追加されます。

• 対話グリッドのアイコン・ビューについて
  
• 対話グリッドへのアイコン・ビューの追加
  
• 対話グリッドへのカスタム・アイコン・ビュー・リンクの追加
  

9.5.2.7.1 対話グリッドのアイコン・ビューについて

対話グリッドはデータの様々なビューをサポートしています。ユーザーは、ビュー選択ボタン・グループのボタンをクリックして、これらのビューを切り替えることができます。次の図に、アイコン・ビューが有効化され、アイコン・ボタンが選択された対話グリッドを示します。アイコン・ビューを有効化するには、アイコン、ラベルおよびターゲット(つまり、リンク)を識別するために使用する列を指定する必要があります。

図GUID-060A0CB3-C95D-49E7-9DBB-20C2E93BCCA0-default.pngの説明

アイコン・ビューの実際の例の表示

このアイコン・ビューの実際の例を参照するには、サンプル・アプリケーションのサンプル対話グリッドをインストールして、レポート、アイコン・ビューおよび詳細ビューを確認します。

関連項目:

パッケージ・アプリケーションのインストール

9.5.2.7.2 対話グリッドへのアイコン・ビューの追加

アイコン・ビューの重要な要件は、ビューの各アイテムが同じ幅と高さを持ち、アイテム・コンテンツがはみ出さないことです。幅と高さは、クラスa-IconList-itemの要素でCSSルールを使用して設定されます。

対話グリッドにアイコン・ビューを追加するには、次のステップを実行します。

対話グリッドにアイコン・ビューを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。

   ヒント:

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択します。

4. 「アイコン・ビュー」を検索します。
5. 次の「アイコン・ビュー」属性を構成します。

   ヒント:

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

   1. 表示: アイコン・ビューを有効にするかどうかを指定します。「はい」を選択します。
   2. カスタム - 「いいえ」を選択します。「はい」を選択すると、アイコン・ビュー・アイテムのマークアップを完全に制御できますが、HTMLマークアップについて完全に理解している必要があります。
   3. アイコン・タイプ: アイコン・イメージ・ソースを保持する列タイプを選択します。「アイコンCSSクラス」を選択します。また、アイコンのCSSクラスである値を持つSQL文に列を追加する必要があります(フォントAPEXアイコン・クラス名)。「URLのイメージ」を選択して、URLおよびアイコン属性を含む列を指定することもできます。
   4. アイコン: アイコン・イメージ・ソースのCSSクラスを戻す対話グリッド列を選択します。
   5. リンク・ターゲット: 「リンク・ビルダー - リンク・ターゲット」ダイアログを表示する「リンク・ターゲット」をクリックします。アイコン・リンクをマウスまたはキーボードでアクティブ化すると、定義されたリンク・ターゲットがたどられます。
   6. リンク属性: 各「リンク・ターゲット」の表示と関連付けられるHTML属性を入力します。
   7. ラベル列: イメージ・ラベルを返す列を選択します。
6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

9.5.2.7.3 対話グリッドへのカスタム・アイコン・ビュー・リンクの追加

カスタム・アイコン・ビュー・リンクでは、複数列を使用できるなど、アイコン・ビューのコンテンツをより柔軟に定義できます。

対話グリッドにカスタム・アイコン・ビュー・リンクを追加するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。

   ヒント:

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択します。

4. 「アイコン・ビュー」を検索します。
5. 次の「アイコン・ビュー」属性を構成します。

   ヒント:

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

   1. 表示: 「はい」を選択します。
   2. カスタム: 「はい」を選択します。「はい」を選択すると、アイコン・ビュー・アイテムのマークアップを完全に制御できますが、HTMLマークアップについて完全に理解している必要があります。
   3. アイコン・タイプ: アイコン・イメージ・ソースを保持する列タイプを選択します。「アイコンCSSクラス」を選択します。また、アイコンのCSSクラスである値を持つSQL文に列を追加する必要があります(フォントAPEXアイコン・クラス名)。「URLのイメージ」を選択して、URLおよびアイコン属性を含む列を指定することもできます。
   4. アイコン: アイコン・イメージ・ソースのCSSクラスを戻す対話グリッド列を選択します。
   5. リンク・ターゲット: 「リンク・ビルダー - リンク・ターゲット」ダイアログを表示する「リンク・ターゲット」をクリックします。アイコン・リンクをマウスまたはキーボードでアクティブ化すると、定義されたリンク・ターゲットがたどられます。
   6. リンク属性: 各「リンク・ターゲット」の表示と関連付けられるHTML属性を入力します。
   7. ラベル列: イメージ・ラベルを返す列を選択します。
6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

9.5.2.8 対話グリッドでの詳細ビューの有効化

対話グリッドはデータの様々なビューをサポートしています。デフォルトで、対話グリッドではグリッド・ビューにデータが表示されます。開発者は、必要に応じて詳細ビューにデータを表示できます。詳細ビューを有効にすると、「詳細」ボタンがビュー選択ボタン・グループに追加されます。

• 対話グリッドの詳細ビューについて
  
• 対話グリッドへの詳細ビューの追加
  

9.5.2.8.1 対話グリッドの詳細ビューについて

対話グリッドはデータの様々なビューをサポートしています。ユーザーは、ビュー選択ボタン・グループのボタンをクリックして、これらのビューを切り替えることができます。次の図に、詳細ビューが有効化され、「詳細」ボタンが選択された対話グリッドを示します。詳細ビューには、開発者が定義したHTMLマークアップを使用して列値が表示されます(次の図を参照)。

図GUID-469D06D1-120C-4071-B91F-78EFE8F3EC7C-default.pngの説明

アイコン・ビューの実際の例の表示

このアイコン・ビューの実際の例を参照するには、サンプル・アプリケーションのサンプル対話グリッドをインストールして、レポート、アイコン・ビューおよび詳細ビューを確認します。

関連項目:

パッケージ・アプリケーションのインストール

9.5.2.8.2 対話グリッドへの詳細ビューの追加

対話グリッドに詳細ビューを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。
3. リージョンで、「属性」ノードを選択します。

   プロパティ・エディタに属性が表示されます。属性は、グループに編成されます。

   ヒント:

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択できます。

4. 「詳細ビュー」を検索します。
5. 次の「詳細ビュー」属性を構成します。
   1. 表示: 「はい」を選択します。
   2. 行の前: レポート行の前に表示するHTMLを入力します。
   3. 各行 - 詳細ビューで各レポート行に使用するHTMLテンプレートを入力します。列名および列ラベルに#COLUMN_NAME#置換文字列を使用します。

      使用可能な置換文字列は次のとおりです。

      • &COLUMN_NAME. - 列ラベルと名前の置換文字列。

      • &APEX$ROW_ID. - 行のレコード識別子。

      • &APEX$ROW_INDEX. - レコード表示順序番号。

      次に例を示します。

      <tr><td align="right">&ENAME_LABEL.:</td><td>&ENAME.</td></tr> <tr><td align="right">&JOB_LABEL.:</td><td>&JOB.</td></tr>

   4. 行の後: レポート行の後に表示するHTMLを入力します。
6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。