Creating a Navigation Bar Entry

Navigation bar entries offer an easy way to move users between pages in an application. For example, a navigation entry enables you to display a link from an image or text. The associated page template determines the location of a navigation bar.

Topics in this section include:

About Navigation Bars

A navigation bar entry can be an image, text, or an image with text beneath it. You must supply the images and text to use in the navigation bar entries.

Description of nav_bar_2.gif follows
Description of the illustration nav_bar_2.gif

Navigation bars are different from other shared components in that you do not need to reference them on a page-by-page basis. If your page template includes the #NAVIGATION_BAR# substitution string, the Application Express engine automatically includes any defined navigation bars when it renders the page.

How to Create a Navigation Bar Entry

Before adding a navigation bar, you must create entries for the navigation bar. To do so, access the Navigation Bar page from either the Page Definition or from the Shared Components page.

To create a navigation bar entry:

  1. Navigate to the appropriate Page Definition. See "Accessing a Page Definition".

  2. Under Shared Components, scroll down to Navigation Bar.

  3. Under Navigation Bar, click the Create icon.

    The Create Navigation Bar Entry Wizard appears. Note that each wizard page displays a series of blocks on the left, representing the sequence of steps. The highlighted block indicates the step you are performing.

  4. For Attributes, specify the appropriate information:

    1. Sequence - Specify the order of evaluation for this component.

      Tip:

      To review the existing entries, click the Existing Navigation Bar Entries link at the bottom of the page.
    2. Alt Tag Text - Enter ALT text for navigation icons that are images. If you do not specify an image name, then this text displays.

    3. Icon Image Name - Enter an image name. For naming conventions, click the item label (Icon Image Name). This opens item-level help with a list of supported prefixes and examples of image names.

    4. Image Height - Define the height of the image in pixels.

    5. Width - Define the width of the image in pixels.

    6. Text - For text-only entries, enter the entry text. For images, you can also enter additional text to display with the image. This attribute can be translated.

    7. Click Next.

  5. For Target, specify the target location.

    1. If the target location is a URL, specify the following:

      • Target is a - Select URL.

      • URL Target - Enter a URL. For example:

        http://www.yahoo.com
        
    2. If the target location is a page, specify the following:

      • Target is a - Select Page in this Application.

      • Page - Specify the target page number.

        You can also select reset pagination for this page. Selecting this option causes the page to return to the first set of data meeting a user's new query.

        You can also select Printer Friendly. Selecting this option displays the target page using the application's Printer Friendly template. Printer friendly templates optimize a page for printing. "Changing the Default Templates in a Theme" and "Optimizing a Page for Printing".

      • Request - Specify the request to be used.

      • Clear Cache - Specify the page numbers on which to clear cache.

    3. To set session state (that is, give a listed item a value):

      • Set these items - Enter a comma-delimited list of item names for which you would like to set session state.

      • With these values - Enter a comma-delimited list of values for the items your specified.

        You can specify static values or substitution syntax (for example, &APP_ITEM_NAME.). Note that item values passed to f?p= in the URL cannot contain a colon. Additionally, item values cannot contain commas unless you enclose the entire value in backslashes (for example, \1234,56\).

    4. Click Next.

  6. To set a condition for displaying the navigation bar entry, specify the appropriate conditional information and click Create.

Tip:

In order for a navigation bar to appear, your page template must include the #NAVIGATION_BAR# substitution string. See"Supported Page Template Substitution Strings".

Editing a Navigation Bar Entry

Once you create a navigation bar entry, you can edit it on the Navigation Bar Entries page.

To edit a navigation bar entry:

  1. On the Workspace home page, click the Application Builder icon.

  2. Select an application.

  3. On the Application home page, click Shared Components.

  4. Under Navigation, click Navigation Bar Entries.

    The Navigation Bar Entries page appears. You can change the appearance of the page by making a selection from the View list and clicking Go. Available options include:

    • Icons (the default) displays each navigation bar entry as a large icon. To edit a navigation bar entry, click the icon.

    • Details displays each navigation bar as a line in a report. To edit a navigation bar, click the appropriate sequence number.

  5. Select a navigation bar entry.

    The Edit Navigation Bar Entry page appears.

    The Edit Navigation Bar Entry is divided into the following sections: Sequence, Subscription, Image Attributes, Target, Conditions, Authorization, Configuration, and Comments.

    You can access these sections by scrolling down the page, or by clicking a navigation button at the top of the page. When you select a button at the top of the page, the selected section appears and all other sections are temporarily hidden. To view all sections of the page, click Show All.

  6. Edit the appropriate attributes.

  7. To learn more about a specific item on a page, click the item label.

    When Help is available, the item label changes to red when you pass your cursor over it and the cursor changes to an arrow and question mark. See "About Field-Level Help".

  8. Click Apply Changes.

Editing Multiple Navigation Bar Entries Simultaneously

To edit multiple navigation bar entries simultaneously:

  1. On the Workspace home page, click the Application Builder icon.

  2. Select an application.

  3. On the Application home page, click Shared Components.

  4. Under Navigation, click Navigation Bar Entries.

    The Navigation Bar Entries page appears.

  5. Click Grid Edit at the top of the page.

  6. Edit the appropriate attributes and click Apply Changes.

Using the Reorder Navigation Bar Entries Icon

You can quickly change the order of navigation bar entries by clicking the Reorder Navigation Bar Entries icon on the Page Definition. This icon resembles light green down and up arrows.

Description of reorder_navbar.gif follows
Description of the illustration reorder_navbar.gif

To change the order of the navigation bar entries using the Reorder Tabs icon:

  1. Navigate to the appropriate Page Definition. See "Accessing a Page Definition".

  2. Under Navigation Bar, click the Reorder Navigation Bar Entries icon.

    The Reorder Navigation Bar Entries page appears.

  3. To change the order in which the entries display on this page, click the up and down arrows in the far right column or edit the numbers.

  4. Click Apply Changes.

Accessing Navigation Bar Entry Reports

You can view the Navigation Bar Entry Subscription and Navigation Bar Entry History reports by clicking the appropriate tab at the top of the Navigation Bar Entries page.

Note:

The Subscription and History buttons only appear after you create a navigation bar.

Navigation Bar Entry Subscription Report

Click Subscription to access the Subscribed NavBars report. This report displays subscribed navigation bar entries in your application.

Navigation Bar Entry History

Click History to view the Navigation Bar History report. This report lists recent changes to navigation bars.