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

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

トピック:

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

関連項目:

ページ・デザイナでのページの管理

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

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

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

   プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

   属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 属性を検索するには、「フィルタ・プロパティ」フィールドにキーワード検索を入力します。その用語を含むグループと属性が表示されます。
5. 対象となる属性を編集します。

   ヒント:

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

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

関連項目:

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

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

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

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

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

   プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックして「編集」を展開します。

   対話グリッドが編集可能である場合は、レコードを処理するプロセスが自動的に作成されます。「有効」が「はい」に設定されている場合、追加のオプションが表示されます。

   次の編集オプションを構成します。

   1. 有効: 「はい」を選択します。

   2. 実行可能な操作: サポートされているデータ操作を選択します。オプションには、「行の追加」、「行の更新」、「行の削除」があります。

   3. 許可された行操作列 - 行ごとに許可する操作を制御するには、SQL問合せに列を追加し、ここでその列を選択します。列値は、更新を許可する場合はU、削除を許可する場合はD、両方を許可する場合はUDにする必要があります。

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

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

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

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

   5. 失われた更新タイプ: 失われた更新に対してデータを保護する方法を選択します。失われた更新は、2人以上のユーザーが同じデータを更新しようとしたときに、最初のユーザーが行った更新が最後の更新によって上書きされる場合に発生します。これが起きるのを防ぐために、更新ではデータベース内の既存の列値と、レコードが最初に問い合されたときに取得された値をチェックできます。

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

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

関連項目:

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

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

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

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

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

   プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックして「ページ区切り」を展開します。

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

   ヒント:

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

   次の「ページ区切り」属性を構成します。

   1. タイプ: オプションを選択します。

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

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

   2. 総行数の表示: 「はい」または「いいえ」を選択します。

      「はい」を選択すると、レポート・フッターに総行数が表示されます。このオプションを有効にすると、追加の問合せが必要となり、非常に大きいデータ・セットのパフォーマンスが妨げられる場合があります。

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

ヒント:

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

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

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

注意:

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

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

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

   プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックしてツールバーを展開します。

   ヒント:

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

5. 「表示」で、「はい」または「いいえ」を選択して、レポートの上部にツールバーを表示するかどうかを決定します。
6. 「ボタン」で、ツールバーに表示されるボタンを選択します。

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

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

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

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

ヒント:

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

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

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

ヒント:

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

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

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

   プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックして「ユーザーの有効化」を展開します。
5. 「パブリック・レポートの保存」で、「はい」を選択します。
6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

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

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

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

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

   プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックして「ユーザーの有効化」を展開します。
5. 「パブリック・レポートの保存」で、「はい」を選択します。
6. 「パブリック・レポートの保存の認可」で、認可スキームを選択します。

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

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

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

対話グリッドはデータの様々なビューをサポートしています。グリッド・ビューはデフォルトで表示され、ユーザーはチャート・ビューを定義することもできます。開発者はオプションで、ビュー選択ボタン・グループにアイコン・ボタンを追加できます(次の図を参照)。

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

アイコン・ビューを利用するには、アイコン、ラベルおよびターゲット(つまり、リンク)を識別するために使用する列を指定します。

ヒント:

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

トピック:

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

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

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

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

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

   プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「アイコン・ビュー」を見つけて展開します。
5. 次の「アイコン・ビュー」属性を構成します。

   ヒント:

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

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

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

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

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

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

   プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「アイコン・ビュー」を見つけて展開します。
5. 次の「アイコン・ビュー」属性を構成します。

   ヒント:

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

   1. 表示: 「はい」を選択します。
   2. カスタム - アイコン・ビューのカスタム・リンクを定義するかどうかを指定します。このオプションでは、複数列を使用できるなど、アイコン・ビューのコンテンツをより柔軟に定義できます。「はい」または「いいえ」を選択します。
   3. アイコン・タイプ: アイコン・イメージ・ソースを保持する列タイプを選択します。「アイコンCSSクラス」を選択します。また、アイコンのCSSクラスである値を持つSQL文に列を追加する必要があります(フォントAPEXアイコン・クラス名)。「URLのイメージ」を選択して、URLおよびアイコン属性を含む列を指定することもできます。
   4. アイコンCSS - アイコンCSSクラスを保持する列を選択します。
   5. リンク・ターゲット: 「リンク・ビルダー - リンク・ターゲット」ダイアログを表示する「リンク・ターゲット」をクリックします。リンク・ターゲットを定義します。アイコン・リンクをマウスまたはキーボードでアクティブ化すると、定義されたリンク・ターゲットがたどられます。
   6. ラベル列 - アイコン・アイテムに使用するラベルを含む列を選択します。
6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

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

対話グリッドはデータの様々なビューをサポートしています。デフォルトでは、グリッド・ビューは常に含められ、ユーザーはチャート・ビューを定義できます。オプションで詳細ビューを定義できます。このビューには、開発者が定義したHTMLマークアップを使用して列値が表示されます(次の図を参照)。

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

ヒント:

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

トピック:

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

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

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

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. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。