JSFナビゲーション・ルールの作成および編集

JSFナビゲーション・ダイアグラムを使用すると、特定の2つのページ間に静的および動的なJSFナビゲーション・ルールを作成できます。また、JSF構成エディタを使用すると、他のJSFナビゲーション・ルール(例: パターン、グローバル・ルールおよびデフォルト・ルールを使用したルール)を定義できます。ルールを作成するには、最初にJSFナビゲーション・ダイアグラムにナビゲーション・ケースを描画し、次にJSF構成エディタでルールを編集して、必要なパターンや他の値を使用できます。

ナビゲーション・ダイアグラムに表示されたナビゲーション・ルールは、そのダイアグラムから直接編集できます。JSF構成エディタを使用すると、グローバル・ルールやデフォルト・ルールも含めてすべてのナビゲーション・ルールを編集できます。

JSFナビゲーション・ダイアグラムを使用してナビゲーション・ケースを定義する手順は、次のとおりです。

  1. 対象プロジェクトのJSFナビゲーション・ダイアグラムを表示します

  2. JSPページをJSFナビゲーション・ダイアグラムに追加します。「JSFナビゲーション・ダイアグラムへの要素の追加」を参照してください。

  3. ナビゲーション・ケースを定義するページ間にナビゲーション・リンクを追加します。「JSFナビゲーション・ダイアグラムへの要素の追加」を参照してください。

  4. ダイアグラム上でナビゲーション・ケースをダブルクリックします。

  5. 「navigation-caseのプロパティ」ダイアログを使用して、ナビゲーション・ケースを定義します。このダイアログを使用して定義できるのは、ナビゲーション・ケースのプロパティのみで、ナビゲーション・ルール全体は定義できません。フィールド名の上にマウス・ポインタを置くと、各フィールドの使用方法の詳細が表示されます。ナビゲーション・ケースに関する参照情報については、「ヘルプ」をクリックしてください。

JSF構成エディタを使用してナビゲーション・ルールを定義する手順は、次のとおりです。

  1. JSF構成エディタを開きます

  2. 要素リストから「ナビゲーション・ルール」を選択します。

  3. 「新規」を選択します。

  4. 「ナビゲーション・ルールの作成」ダイアログを使用して、ナビゲーション・ルールの<from-view-id>に使用するページのパスまたはパターンを指定します。

    グローバル・ナビゲーション・ルールの場合は、「ビューID(自)」でパターン*を使用するか、「ビューID(自)」を空のままにします。または、ドロップダウン・リストを使用して「グローバル・ナビゲーション・ルール」を選択します。いずれの場合も、すべてのビューからルールが適用されることを示します(「ビューID(自)」フィールドを空のままにすると、ルールは作成されますが、JSF構成エディタのルール・リストにそのルールが表示されません。かわりに、ドロップダウン・リストに表示される「グローバル・ナビゲーション・ルール」を使用します)。

JSF構成エディタを使用してルールのナビゲーション・ケースを定義する手順は、次のとおりです。

  1. JSF構成エディタを開きます

  2. 要素リストから「ナビゲーション・ルール」を選択します。

  3. 「ナビゲーション・ルール」のリストから、ナビゲーション・ケースを定義するルールを選択します。

  4. 新規のナビゲーション・ケースを追加するには、「ナビゲーション・ケース」のリストの横にある「新規」をクリックします。

    既存のナビゲーション・ケースを編集するには、「ナビゲーション・ケース」のリストから編集するケースを選択して「編集」をクリックします。

  5. 「ナビゲーション・ケースの作成」ダイアログまたは「navigation-caseのプロパティ」ダイアログを使用して、ナビゲーション・ケースを定義します。ナビゲーション・ケースのリンク先を識別するには、「ビューID(至)」を指定する必要がありますが、「アクション(自)」「結果(自)」のいずれかまたは両方は空のままにできます。いずれかを空のままにすると、指定したアクション・メソッドからのすべての結果、または指定した結果(結果が戻る方法に関係なく)に対してこのケースが適用されます。両方を空のままにすると、このルールと<from-view-id>が同じ他のルールで識別されないすべてのケースに対してこのケースが適用されます。

JSFナビゲーション・ダイアグラムからナビゲーション・ケースを編集する手順は、次のとおりです。

  1. 対象プロジェクトのJSFナビゲーション・ダイアグラムを表示します

  2. ダイアグラム上で、編集するナビゲーション・ケースをダブルクリックします。

  3. 「navigation-caseのプロパティ」ダイアログを使用して、ナビゲーション・ケースを定義します。このダイアログを使用して定義できるのは、ナビゲーション・ケースのプロパティのみで、ナビゲーション・ルール全体は定義できません。フィールド名の上にマウス・ポインタを置くと、各フィールドの使用方法の詳細が表示されます。ナビゲーション・ケースに関する参照情報については、「ヘルプ」をクリックしてください。

JSF構成エディタを使用してナビゲーション・ルールとそのケースを編集する手順は、次のとおりです。

  1. JSF構成エディタを開きます

  2. 要素リストから「ナビゲーション・ルール」を選択します。

  3. 「ナビゲーション・ルール」のリストから、編集するルールを選択します。

  4. ルールを編集するには、次のいずれかを実行します。

    ルールの「ビューID(自)」を編集するには、「編集」をクリックします。

    ナビゲーション・ケースを追加するには、ダイアログの「ナビゲーション・ケース」領域にある「新規」をクリックします。

    ナビゲーション・ケースを編集するには、ナビゲーション・ケースを選択し、ダイアログの「ナビゲーション・ケース」領域にある「編集」をクリックします。

    フィールド名の上にマウス・ポインタを置くと、ダイアログ内にある各フィールドの使用方法の詳細が表示されます。ナビゲーション・ルールとケースに関する参照情報については、「ヘルプ」をクリックしてください。


JSFアプリケーションでのナビゲーションについて
JSFナビゲーション・ルールについて
JSFナビゲーション・ケースについて
JSFナビゲーション・ルールの評価について
JSF編集ツールについて