データ・テーブルでは、パラメーターを Faces JSP ページから別のページに渡すことができます。
コマンド・ボタン、コマンド・ハイパーリンクといった幾つかの Faces コンポーネントにより、
この操作を支援します。
これを行うには、データ・テーブルの行アクションを使用できます。
例えば、データ・テーブルでユーザーが選択するレコード・データの詳細ページを戻すことができます。
これを行うには、データ・テーブルの行アクションを使用して、
データ・テーブル・ページから詳細ページにパラメーターを渡すことができます。
(データ・テーブルの列にバインドされる「コマンド - ハイパーリンク」コンポーネントを使用して、
パラメーターを渡すこともできます。)
- 前述のように、データ・テーブルに行アクション・コントロールを追加する。
データ・テーブルの「プロパティー」ビューの「行アクション」タブで、
「行がクリックされたときに実行されるアクションの追加」の横にある「追加」をクリックする。 行アクションを持つ新規列がデータ・テーブルに追加されます。
行アクション・コントロールが選択されます。
- 行アクション・コントロール (commandExRowAction) の「プロパティー」ビューで、
行アクション用のアクションをコード化するための「クイック編集」ビューに切り替えることができます
(そして、ナビゲーション規則を使用してアクションが進むべきページを識別することもできます)。
行アクション用のカスタム・アクションを作成する方法は、以下のとおりです。
- 「プロパティー」ビューの「クイック編集」ビュー・ボタンをクリックして、
行アクションの「クイック編集」ビューを開く。
- 「クイック編集」ビューの右側のペインをクリックする。
- 新規アクションを定義するコードを入力する。
- ナビゲーション規則をセットアップする (アクションが進むべきページを識別する) には、
『Faces JSP ページにおけるナビゲーション規則の使用』を参照してください。
- 行アクションにパラメーターを追加する。
- 「行アクション」の「パラメーター」タブを選択する。
- 「パラメーターの追加」をクリックする。
- 「名前」フィールドをクリックして、新規パラメーターの名前を入力する。
データ・テーブルの列 (ID など) に相当する名前を入力できます。
- パラメーターに値を設定するか、その値をデータ・オブジェクト内のフィールドにバインドすることができます。
データ・フィールドにバインドするには、新規パラメーターの「値」フィールドをクリックする。
- 値フィールドで表示するボタンをクリックする。 「ページ・データ・オブジェクトの選択」ダイアログが開きます。
- パラメーターにバインドする関連レコードを選択する。
例えば、
データ・テーブルのバインド先である同じ関連レコード・リスト内の 「ID」フィールドを選択できます。
行アクションを作成した後で、「プロジェクト・エクスプローラー」ビューでページを右クリックし、の順に選択することで、そのページをテスト・サーバーで実行できます。