Faces JSP ページにおけるナビゲーション規則の使用

同一のプロジェクト内で、ある Faces JSP ページから別の Faces JSP ページへのナビゲーションを作成する場合は、 ナビゲーション規則を使用します。ナビゲーション規則とは、 元のページで特定の結果が生じた場合に、ジャンプ先のページを設定する規則のことです。 例えば、ユーザーが「実行」ボタンをクリックしようとして エラー・メッセージを受け取った場合、ナビゲーション規則により自動的に、 ユーザーがこの問題を解決するための方法を説明する新しいページにナビゲートすることができます。

注: 外部 Web ページへのナビゲーションを作成したい場合は、「リンク」コンポーネントを使用してください。 「リンク」コンポーネントを該当ページにドラッグしてから、外部ターゲットとラベルを指定します。
ナビゲーション規則を作成する方法:
  1. 以下のいずれかのコンポーネントをページ上に作成し選択する。
    • ボタン - コマンド
    • リンク - コマンド
    • リンク - 要求
    • 「データ・テーブルの行アクション」コンポーネント
    コンポーネントの「プロパティー」ビューを開く。
  2. 「プロパティー」ビューのクイック編集ビュー・ボタンをクリックしてクイック編集ビューに切り替え、 このコンポーネントが実行できるアクションをコーディングする。 このアクションは少なくとも 1 つの値を戻さなければなりません。
  3. 「プロパティー」ビューで、「規則の追加」をクリックする。 「ナビゲーション規則の追加」ダイアログが開き、 このページで、このコンポーネントのナビゲーション規則を設定することができます。
  4. 「ナビゲーション規則の追加」ダイアログで、次の手順を実行する。
    1. 「ジャンプ先のページ」セクションで、 ナビゲート先のページを選択する。
    2. 「アクションが結果を戻す条件」セクションで、 「任意の結果」を選択するか、あるいは結果に名前を付ける。
    3. 「この規則の使用対象」セクションで、 ナビゲーション規則をすべてのページで使用すること、 またはこのページでのみ使用することを選択する。 そして、この規則を任意のアクションで使用するか、 または自分自身で指定したアクションで使用するかについても選択する。
    4. 「この規則に従う場合」セクションで、 パラメーターを自動的に動作させる (リクエスト転送) か、 それともパラメーターをコード化するか (リクエスト・リダイレクト) かを選択する。 このコンポーネントの「プロパティー」ビューの「パラメーター」タブで、 パラメーターの設定が行えることに注目してください。
    5. OK」をクリックします。 この規則が「プロパティー」ビュー内のテーブルに追加されます。
少なくとも、コンポーネントを選択して、「クイック編集」ビューで、 ヌルではなく「別名」を戻すように変更することができます。 デフォルトでは、別名は * になります。 つまり、ヌル以外のすべての戻りコードがこのナビゲーション規則を起動します。 指定されたコンポーネントの戻りコードを「クイック編集」ビューで設定できます。 コマンド・イベントを選択して、「クイック編集」ビューの右ペインで、 少なくとも「return""」だけは指定します。 この場合は * に基づいて規則を起動する空ストリングが戻されます。 特定の別名 (例えば、"success") をセットアップしている場合、 そのナビゲーション規則を起動するには、アクションによって "success" が戻される必要があります。 ナビゲーション規則を特定のアクションにのみ適用する (有効範囲内のアクションを選択する) ことができます。 ナビゲーション規則を現在のページに適用することも、あるいはプロジェクト内のすべてのページに適用することも可能です。 特定のアクションに絞り込まない限り、 「プロパティー」ビューを使用して明示的に追加されている、いないに関係なく、 すべてのアクションがこれらのナビゲーション規則を使用します。

ナビゲーション規則の使用について、さらに学習される場合は、 以下のチュートリアルに従ってください (特に、ナビゲーション規則の使用に関する課題):

チュートリアル: JavaServer Faces による Web ページでの動的情報の表示。 このチュートリアルでは、新聞の案内広告欄として機能する動的 Web サイトの設計方法を学習します。この Web サイトは、JavaServer Faces (JSF) コンポーネントおよび Service Data Objects (SDO) コンポーネントを使用する、完全な J2EE サンプル・アプリケーションです。Web アプリケーションでは JSF テクノロジーを使用して、案内広告データが保管されているデータベースにリンクする動的 Web ページを作成します。チュートリアル: JavaServer Faces による Web ページでの動的情報の表示。 このチュートリアルでは、新聞の案内広告欄として機能する動的 Web サイトの設計方法を学習します。この Web サイトは、JavaServer Faces (JSF) コンポーネントおよび Service Data Objects (SDO) コンポーネントを使用する、完全な J2EE サンプル・アプリケーションです。Web アプリケーションでは JSF テクノロジーを使用して、案内広告データが保管されているデータベースにリンクする動的 Web ページを作成します。

関連概念
データ・テーブル・コンポーネント
関連タスク
データ・ソースに接続する入力フォームの作成
Faces JSP ページへの入力コンポーネントの追加
Faces JSP ファイルへの選択リストの追加
Faces JSP ファイルへのハイパーリンクの追加
ファイル・アップロード・コンポーネントの使用
JavaServer Faces アプリケーションにおけるエラーの管理
Faces JSP ファイルの作成
関連資料
ボタン - コマンド
リンク - コマンド
コマンド行アクション
リンク
リンク - 要求
メニュー・バー
アクション・バー
行要求アクション

フィードバック