JSFナビゲーション・ダイアグラムへの要素の追加

アプリケーション内のページおよびページ間のリンクやナビゲーションを表すダイアグラムを作成するには、JSFナビゲーション・ダイアグラムとコンポーネント・パレットを使用します。ダイアグラムに追加したナビゲーション・ケースは、JSF構成ファイル(faces-config.xml)に反映され、ファイルを直接編集する必要はありません。

JSFナビゲーション・ダイアグラムにJSF JSPページを追加する手順は、次のとおりです。

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

  2. コンポーネント・パレットのJSFナビゲーション・ダイアグラム・ページで、「JSFページ」を選択します。

  3. ダイアグラムにページを追加するには、次のいずれかの操作を行います。

    ページのアイコンがページ名のラベルとともにダイアグラム上に表示されます。最初は、新規JSFページを定義するまで、アイコンに警告マークが重なって表示されます。次に例を示します。

    警告表示のあるJSFページ・アイコン

  4. ページの名前を指定するには、ダイアグラムでアイコンのラベルをクリックし、ラベルを編集します。ページを実行可能にするために名前の先頭にスラッシュが必要です。ページ名を変更するときにスラッシュを削除しても、スラッシュが復元されます。

  5. 新規ページを定義するには、アイコンをダブルクリックし、「JSF JSPの作成 - JSPファイル」ダイアログを使用します。ダイアログの使用に関するヘルプを参照するには、ページ上の「ヘルプ」をクリックします。ページの作成が完了すると、アイコンの警告マークは表示されなくなります。

  6. JSFナビゲーション・ダイアグラムに対する変更を保存します。

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

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

  2. まだ定義していない場合は、作成するナビゲーション・ケースのリンク元の<from-view-id>およびリンク先の<to-view-id>となるJSFページを定義します

  3. コンポーネント・パレットのJSFナビゲーション・ダイアグラム・ページで、「JSFナビゲーション・ケース」を選択します。

  4. ナビゲーション・ケースのリンク元JSFページのアイコンをクリックし、次にリンク先JSFページのアイコンをクリックします。

    ナビゲーション・ケースをリンク元ページとリンク先ページの間の直線で描画するには、リンク元ページをクリックした後でリンク先ページをクリックします。次に例を示します。

    テキストで説明されている例

    ナビゲーション・ケースの線を途中で曲げて描画するには、リンク元ページをクリックし、線を曲げる場所までドラッグしてその場所でダイアグラム上をクリックし、その後でリンク先ページをクリックします。次に例を示します。

    テキストで説明されている例

  5. ナビゲーション・ケースはダイアグラム上に実線で表示され、ナビゲーション・ケースのラベルとしてデフォルトの<from-outcome>値が表示されます。<from-outcome>値を編集するには、ラベルをクリックして新しい値を入力します。

  6. リンク元ページに対するナビゲーション・ルールが存在していない場合は、ナビゲーション・ルールがJSF構成ファイルに追加され、そのルールに対してナビゲーション・ケースが追加されます。

  7. JSFナビゲーション・ダイアグラムに対する変更を保存し、JSF構成ファイルに対する変更を保存します。

JSFナビゲーション・ダイアグラムにノートを追加する手順は、次のとおりです。

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

  2. コンポーネント・パレットのJSFナビゲーション・ダイアグラム・ページで、Noteを選択します。

  3. ダイアグラム上のノートを追加する場所をクリックします。

    ダイアグラム上にノートが表示され、テキストを入力できる場所にカーソルが表示されます。

  4. テキストを入力した後、ノートの外側をクリックします。

  5. 編集のためにノートのテキストを選択するには、ノート内の任意の場所をクリックします。

    ノート自体を選択するには、右上隅をクリックします。

  6. JSFナビゲーション・ダイアグラムに対する変更を保存します。

ノートおよび添付はJSFナビゲーション・ダイアグラムにのみ表示され、JSFアプリケーション構成ファイルには表示されません。

JSFナビゲーション・ダイアグラム内の要素にノートを添付する手順は、次のとおりです。

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

  2. ノートがダイアグラムに存在していない場合は、ノートを追加します

  3. コンポーネント・パレットのJSFナビゲーション・ダイアグラム・ページで、Attachmentを選択します。

  4. ダイアグラムでノートをクリックし、次にノートを添付する要素をクリックします。

    添付を表す点線が表示されます。

  5. JSFナビゲーション・ダイアグラムに対する変更を保存します。

ノートおよび添付はJSFナビゲーション・ダイアグラムにのみ表示され、JSF構成ファイルには表示されません。


JSFでのページ・ナビゲーションの管理
JSFナビゲーション・ダイアグラムの操作
JSFアプリケーションの編集スタイルの選択
ダイアグラム上の連結部のレイアウト