# Add Navigation Case Dialog Box

Use to register a navigation case with the application by adding an entry to the Faces configuration file.

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.

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.

Element | Description
--- | ---
From View | (`<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 | (`<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 | (`<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 | (`<to-view-id>`) Specifies the identifier of the view that should be displayed if the navigation rule is matched.
Redirect | (`<redirect>`) Specifies that navigation to the view id should be accomplished by performing an HTTP redirect rather than the usual `ViewHandler` mechanisms.
Rule Description | (`<description>`) Specifies a textual description of the element it is nested in, optionally flagged with a language code using the `xml:lang` attribute.

Related Topics

Developing Applications with NetBeans IDE,

Developing Applications with NetBeans IDE,

Copyright © 2015, Oracle and/or its affiliates. All rights reserved.