「リンク」コンポーネントおよび「コマンド - ハイパーリンク」コンポーネントを使用して、
サイト・ジャンプとページ・ジャンプを Web プロジェクトに追加できます。
一般に、「リンク」コンポーネントは Web プロジェクトの外側にある Web ページにリンクする場合に使用し、
「コマンド - ハイパーリンク」コンポーネントは内部ページにリンクする場合に使用します。
「コマンド - ハイパーリンク」コンポーネントは、リンクがアクティブになったときに、
追加のアクションを使用可能にする場合にも使用できます。
ハイパーリンクは更新を実行して、ナビゲート先である Web プロジェクト内の次のページを識別できます。
例えば、関連レコード・リスト内の単一行に適用するアクションに、
「コマンド - ハイパーリンク」コンポーネントを使用できます。
Faces JSP ページに「コマンド - ハイパーリンク」コンポーネントを追加する方法は、次のとおりです。
- 「コマンド - ハイパーリンク」コンポーネントを、パレットから該当ページへ、
または該当ページに既にある「出力」コンポーネントあるいは「イメージ」コンポーネントへドラッグする。
注: 「コマンド - ハイパーリンク」コンポーネントを Faces JSP ページのブランク域にドロップした場合、
その「コマンド - ハイパーリンク」コンポーネントには自動的に「出力」コンポーネントが追加されます。
この出力テキストには、リンクのラベルが含まれます。
- ラベルを変更するには、「出力テキスト」コンポーネントを選択する。
「出力テキスト」コンポーネントの「プロパティー」ビューで、
「値」フィールドに新しいラベルを入力する。
これは実行時に表示されるリンク・テキストです。
- このリンク・アイコンが選択されていることを確認し、「クイック編集」ビューを使用して、
このリンクのアクションをコマンド・イベントとして作成する。
(『Web ページへのスクリプト・イベントの追加』を参照してください。)
- 次に、「コマンド - ハイパーリンク」コンポーネントの「プロパティー」ビューで「規則の追加」をクリックして、
ナビゲーションを追加する。
「ナビゲーション規則の追加」ダイアログが開きます。
ナビゲーション規則により、発生内容 (例えば、エラーなど) に応じてユーザーを特定のページに誘導できます。
ここで、「クイック編集」ビューで実行するアクションを定義します。
ナビゲーション規則はアクションからの戻り値をベースにして、進むべきページを判別します
(例えば、戻り値が success であり、
failure でなければ、特定のページに進むことができます。)。.
ナビゲーション規則により、指定されたアクションに特定したり、あるいは任意のアクションを適用したりすることができます。
さらに、指定されたページへのみ、あるいはプロジェクトのすべてのページにこの規則を適用させることもできます。
- 必要に応じて、さらに「コマンド - ハイパーリンク」プロパティーを設定する。例えば、
「コマンド - ハイパーリンク」の「プロパティー」ビューの「パラメーター」タブで、
任意のパラメーターを追加できます。追加されたパラメーターは、アクションに渡されます。