blob: dcefb1b472791f136b7d70413a11d907bb06b893 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<title>Add Navigation Rule Dialog Box</title>
<link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/>
</head>
<body>
<p><a id="org.netbeans.modules.web.jsf.dialogs.AddNavigationRuleDialog" name="org.netbeans.modules.web.jsf.dialogs.AddNavigationRuleDialog"></a></p>
<div id="NBCSH4156"><!-- infolevel="all" infotype="General" --><a id="sthref553" name="sthref553"></a>
<h1>Add Navigation Rule Dialog Box</h1>
<a name="BEGIN" id="BEGIN"></a>
<p>Use to register a navigation rule with the application by adding an entry to the Faces configuration file.
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1148">
<param name="text" value="<html><u>How?</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p>You apply a navigation rule to specify which view should be displayed, based on the value of an outcome produced by the application's business logic. JSF's <code dir="ltr">NavigationHandler</code> handles the outcomes, and forwards them to views determined by navigation rules and the cases they contain.</p>
<p>JSF 2.0 applications do not require the <code dir="ltr">faces-config.xml</code> file. Navigation rules and the cases they contain can be managed <i>implicitly</i>, meaning that they can be determined by matching outcome values with the names of pages contained in the application's web root.</p>
<table summary="User interface elements and descriptions" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
<col width="24%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t5">Element</th>
<th align="left" valign="bottom" id="r1c2-t5">Description</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t5" headers="r1c1-t5">
<p>Rule from View</p>
</td>
<td align="left" headers="r2c1-t5 r1c2-t5">(<code dir="ltr">&lt;from-view-id&gt;</code>) Specifies the identifier of the view from which the request originated.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t5" headers="r1c1-t5">
<p>Rule Description</p>
</td>
<td align="left" headers="r3c1-t5 r1c2-t5">(<code dir="ltr">&lt;description&gt;</code>) An optional textual description of the element, which can be flagged with a language code using the <code dir="ltr">xml:lang</code> attribute.</td>
</tr>
</tbody>
</table>
<br />
<!-- -->
<a id="NBCSH4159" name="NBCSH4159"></a>
<hr><p><b>Related Topics</b></p>
<p><i>Developing Applications with NetBeans IDE</i>,
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1141">
<param name="text" value="<html><u>&quot;Working with the JavaServer Faces Framework&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<!-- -->
<!-- Start Footer -->
<table summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" width="86%"><a href="legal_notice.htm">
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a>
</td>
</tr>
</table>
<!-- -->
</body>
</html>