A navigation case describes a particular condition (or set of conditions) that
must be met for the navigation rule in which it is nested to be triggered. JSF's
NavigationHandler
handles outcomes by forwarding requests to the
view defined in a navigation case's <to-view-id>
tags.
You arrive at this dialog box by right-clicking in a Faces configuration file
(faces-config.xml
) and choosing Insert > Navigation Case. The
purpose of the dialog is to register a navigation case with the application
by adding an entry to the Faces configuration file.
JSF 2.0 applications do not require the faces-config.xml
file. Navigation cases can be managed implicitly, meaning that navigation
rules can be determined by matching outcome values with the names of pages
contained in the application's web root.
<from-view-id>
) Specifies
the view identifier of the view for which the containing navigation rule
is relevant. If no value is specified, the rule applies to navigation
decisions for all views.<from-action>
) Specifies
an action reference expression that must have been executed (by the default
ActionListener
for handling application level events) in order
to select this navigation rule. If not specified, this rule will be relevant
no matter which action reference was executed (or if no action reference was
executed).<from-outcome>
) Specifies
an outcome string returned by the execution of an application action method
selected via an actionRef
property (or a literal value specified
by an action
property) of a UICommand
component.
If specified, this rule is relevant only if the outcome value matches the
element's value. If not specified, the rule is relevant no matter what the
outcome value was.<to-view-id>
) Specifies the
identifier of the view that should be displayed if the navigation rule is
matched.<redirect>
) Specifies that
navigation to the view id should be accomplished by performing an HTTP
redirect rather than the usual ViewHandler
mechanisms.<description>
)
Specifies a textual description of the element it is nested in, optionally
flagged with a language code using the xml:lang
attribute.