16.5 Controlling Navigation Using Branches

Add navigation to application pages by creating branches. A branch is an instruction to link to a specific page, procedure, or URL after a given page is submitted.

• Creating a Branch
  
• About Branching Conditionally
  

See Also:

"Accessing Page Specific Utilities"

16.5.1 Creating a Branch

To create a branch:

1. View the page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select a page.
   Page Designer appears.
2. In either the Rendering or Processing tab, right-click Branches and select Create Branch.

   The Property Editor displays the Branch attributes.

   Page Designer indicates what actions are required next. If there is an error, the Show Messages icon displays next to the Save button. Click the Show Messages icon to view a dialog listing all the errors. Select an error to highlight the associated attribute in the Property Editor.

   1. Identification, Name - Specify the name of the branch for easy identification by developers.
   2. Execution Options:

      1. Sequence - Specify the sequence for this component. The sequence determines the order of execution.

      2. Point - Select the point in the processing at which this branch action is considered. Options include:

         • After Submit (previously named Before Computation)

         • Validating (previously named Before Validation)

         • Processing (previously named Before Processing)

         • After Processing (previously named After Processing)

         • Before Header (previously named Before Header)

   3. Behavior, Type - Select a page branch type. To learn more, click the Help tab in the central pane.

      The attributes that display in the Property Editor depend on the branch type you select.

      If Type is Page or URL (Redirect), click Target and edit the attributes in the Link Builder Target dialog.

   4. Server-Side Condition:

      1. When Button Pressed - If you want this page processing component to execute only when the specified button is clicked, select a button from the list. You can incorporate this button condition with other conditions to further refine when this page processing component executes.

      2. Condition Type - Select a condition type from the list that must be met in order for this component to be rendered or processed. To learn more, click the Help tab in the central pane.

3. Edit the Branch attributes:

   Tip:

   To learn more about an attribute, select the attribute in the Property Editor and click the Help tab in the central pane.

4. Click Save.

See Also:

• "About the When Button Pressed Attribute"

• "Creating Pre-Rendering Branches, Computations, and Processes"

• "Creating Page Submission Branches, Validations, Computations, and Processes"

16.5.2 About Branching Conditionally

Like other controls, branches can be made conditional. To a branch conditional, view the branch attributes in the Property Editor. Under Server-side Condition, edit the appropriate attributes.