Edit D:\app\Administrator\product\11.2.0\dbhome_1\apex\images\doc\nav_branch.htm
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> <title>Controlling Navigation Using Branches</title> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 5.1" /> <meta name="date" content="2009-04-14T16:11:30Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Controlling Navigation Using Branches" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="E11947-01" /> <link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" /> <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> <link rel="contents" href="toc.htm" title="Contents" type="text/html" /> <link rel="up" href="preface.htm" title="Home" type="text/html" /> <link rel="up" href="nav.htm" title="Adding Navigation" type="text/html" /> <link rel="up" href="nav_branch.htm" title="Controlling Navigation Usin..." type="text/html" /> <link rel="prev" href="nav_navbar_rpts.htm" title="Previous" type="text/html" /> <link rel="next" href="ui.htm" title="Next" type="text/html" /> </head> <body> <p id="BREADCRUMBING"><a href="preface.htm" title="Home">Home</a> > <a href="nav.htm" title="Adding Navigation">Adding Navigation</a> > Controlling Navigation Usin...</p> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> <col width="86%" /> <col width="*" /> <tr valign="bottom"> <td align="left"></td> <td align="center"><a href="nav_navbar_rpts.htm"><img src="dcommon/gifs/leftnav.gif" alt="Previous" /><br /> <span class="icon">Previous</span></a> </td> <td align="center"><a href="ui.htm"><img src="dcommon/gifs/rightnav.gif" alt="Next" /><br /> <span class="icon">Next</span></a></td> </tr> </table> <p><a id="CHDFCBFE" name="CHDFCBFE"></a></p> <div class="sect1"><!-- infolevel="all" infotype="General" --> <h1><a name="HTMDB07004|branches"></a>Controlling Navigation Using <a id="sthref1432" name="sthref1432"></a><a id="sthref1433" name="sthref1433"></a><a id="sthref1434" name="sthref1434"></a><a id="sthref1435" name="sthref1435"></a>Branches</h1> <p>A branch is an instruction to link to a specific page, procedure, or URL after a given page is submitted. For example, you can branch from page 1 to page 2 after page 1 is submitted.</p> <p>You create a branch by running the Create Branch <a id="sthref1436" name="sthref1436"></a><a id="sthref1437" name="sthref1437"></a><a id="sthref1438" name="sthref1438"></a>Wizard and specifying the branch point and branch type.</p> <p>To create a branch:</p> <ol> <li> <p>Navigate to the appropriate Page Definition. See <a href="bldr_goto_pgdef.htm#CJGHCACC">"Accessing a Page Definition"</a>.</p> </li> <li> <p>Under Branches in the Page Processing column, click the <span class="bold">Create</span> icon.</p> </li> <li> <p>For Point and Type, select a branch point:</p> <ul> <li> <p>On Submit: Before Computation - Occurs before computations, validations, or processing. Use this option for a Cancel button.</p> </li> <li> <p>On Submit: Before Validation - Occurs after computations, but before validations or processing. Typically not used. If a validation fails, page processing stops, a rollback is issued, and the page displays the error. Because of this default behavior, you do not need to create branches to accommodate validations. However, you might want to branch based on the result of a computation (for example, to the previous branch point).</p> </li> <li> <p>On Submit: Before Processing - Occurs after computations and validations, but before processing. Use this option to branch based on a validated session state, but before performing any page processing.</p> </li> <li> <p>On Submit: After Processing - Occurs after computations, validations, and processing. This option branches to a URL or page after performing computations, validations, and processing. When using this option, remember to sequence your branches if you have multiple branches for a given branch point.</p> </li> <li> <p>On Load: Before Header - Occurs before a page is rendered. This option displays another page, instead of the current page, or redirects the user to another URL or procedure.</p> </li> </ul> </li> <li> <p>Select a branch type and click <span class="bold">Next</span>.</p> </li> <li> <p>For Target, specify the target location. The information that appears on the page depends on the branch type you selected:</p> <ol> <li> <p>If the target location is a URL, specify the following:</p> <ul> <li> <p>Target is a - Select <span class="bold">URL</span>.</p> </li> <li> <p>URL Target - Enter a URL. For example:</p> <pre xml:space="preserve" class="oac_no_warn"> http://www.yahoo.com </pre></li> </ul> </li> <li> <p>If the target location is a page, specify the following:</p> <ul> <li> <p>Target is a - Select <span class="bold">Page in this Application</span>.</p> </li> <li> <p>Page - Specify the target page number.</p> <p>You can also select <span class="bold">reset pagination for this page</span>. Selecting this option causes the page to return to the first set of data meeting a user's query.</p> <p>You can also select <span class="bold">include process success message</span>. Selecting this option displays a message when a user submits a page and a branch is taken to another page. If you do not select this option, the message does not display because it is part of submitting the page, not displaying the next one.</p> </li> <li> <p>Request - Specify the request to be used.</p> </li> <li> <p>Clear Cache - Specify the page numbers on which to clear cache. Separate multiple entries with a comma.</p> </li> </ul> </li> <li> <p>To set session state (that is, give a listed item a value):</p> <ul> <li> <p>Set these items - Enter a comma-delimited list of item names for which you would like to set session state.</p> </li> <li> <p>With these values - Enter a comma-delimited list of values for the items your specified.</p> <p>You can specify static values or substitution syntax (for example, <code>&APP_ITEM_NAME.</code>). Note that item values passed to <code>f?p=</code> in the URL cannot contain a colon. Additionally, item values cannot contain commas unless you enclose the entire value in backslashes (for example, <code>\1234,56\</code>).</p> </li> </ul> </li> <li> <p>Select <span class="bold">save state before branching</span> to clear cache and save session state before performing the redirect. See <a href="#CHDEEIFD">"About Saving State Before Branching"</a>.</p> </li> <li> <p>Click <span class="bold">Next</span>.</p> </li> </ol> </li> <li> <p>Follow the on-screen instructions.</p> </li> </ol> <div align="center"> <div class="inftblnotealso"><br /> <table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p class="notep1">See Also:</p> <a href="concept_sub_strings.htm#CHDDCFIJ">"About the When Button Pressed Attribute"</a></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblnotealso" --></div> <a id="sthref1439" name="sthref1439"></a> <p class="subhead2">Creating a Branch on a Page with a Component that Submits</p> <p>If you have a page with a component that submits, such as a Go button or select list with submit, note that you must create a branch that links back to that page. For example, suppose you have a page with a select list and a submit button. For processing to occur properly, you need to create a branch on the page that links back to the page.</p> <a id="CHDEEIFD" name="CHDEEIFD"></a> <p class="subhead2">About Saving State Before Branching</p> <p>Consider selecting save state before branching if your branch is redirecting to a URL or returning a URL and passes clear cache directives or item names and item values in the resulting <code>f?p</code> URL. By default, this information is passed after the branch is taken, displaying any passed information in the URL.</p> <p>Selecting <span class="bold">save state before branching</span> sets potentially sensitive information in session state before the branch redirect. This option improves application security by making URLs less susceptible to tampering and by exposing fewer item names, values, and indications of program logic.</p> <p>Note that when you select <span class="bold">save state before branching</span>, the redirected URL no longer include clear cache or item name and item values. You can still view this information, by running your application in Debug mode. See <a href="debug_mode.htm#BABJEJGI">"Accessing Debug Mode"</a>.</p> </div> <!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> <col width="86%" /> <col width="*" /> <tr> <td align="left"><span class="copyrightlogo">Copyright © 2003, 2009, Oracle and/or its affiliates. All rights reserved.</span><br /> <a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> <td align="center"><a href="nav_navbar_rpts.htm"><img src="dcommon/gifs/leftnav.gif" alt="Previous" /><br /> <span class="icon">Previous</span></a> </td> <td align="center"><a href="ui.htm"><img src="dcommon/gifs/rightnav.gif" alt="Next" /><br /> <span class="icon">Next</span></a></td> </tr> </table> </div> <!-- class="footer" --> </body> </html>
Ms-Dos/Windows
Unix
Write backup
jsp File Browser version 1.2 by
www.vonloesch.de