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

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

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

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

JavaServer Faces による Web ページでの動的情報の表示

Faces Web アプリケーションに関する幾つかの制限を確認するには、 『制限: Faces JSP アプリケーション』を参照してください。

関連概念
Faces コンポーネント
関連タスク
Faces アプリケーションの作成 - 概要
Faces JSP ファイルの作成
関連資料
Faces コンポーネント参照
Faces コンポーネントの属性
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved. (C) Copyright IBM Japan 2005