Creating Breadcrumbs
Provide users with hierarchical navigation by creating breadcrumbs. You can display a breadcrumb as a list of links or as a breadcrumb path.
- What Are Breadcrumbs?
- Creating a Breadcrumb While Creating a Page
- Creating a Breadcrumb Manually
- Editing Breadcrumbs
- Reparenting Breadcrumb Entries
- Deleting Unused Breadcrumb Entries
- Accessing Breadcrumb Reports
See Also:
Parent topic: Adding Navigation
What Are Breadcrumbs?
A breadcrumb is a hierarchical list of links that indicates where the user is within the application from a hierarchical perspective. Users can click a specific breadcrumb link to instantly view the page. You use breadcrumbs as a second level of navigation at the top of each page, complementing other user interface elements such as tabs and lists.
See Also:
Parent topic: Creating Breadcrumbs
Creating a Breadcrumb While Creating a Page
To create a breadcrumb while creating a page:
See Also:
Parent topic: Creating Breadcrumbs
Creating a Breadcrumb Manually
This section describes how to create breadcrumbs manually.
- About Creating a Breadcrumb Manually
- Creating Breadcrumbs as Shared Components
- Creating a Breadcrumb Region Using the Create Breadcrumb Wizard
- Adding a Breadcrumb Region to a Page
- Adding Entries to a Breadcrumb
- About Creating Dynamic Breadcrumbs
Parent topic: Creating Breadcrumbs
About Creating a Breadcrumb Manually
To create breadcrumbs manually, you must add a breadcrumb to each page in your application as follows:
- Create the breadcrumb by running the Create/Edit Breadcrumb Wizard. You can access this wizard in two ways:
- Go the Shared Component page and select Create Breadcrumb.
- In Page Designer, select the Create menu and then Breadcrumb Region.
- Add entries to the breadcrumb.
- Add the breadcrumb to a page by creating a region.
See Also:
"Adding Entries to a Breadcrumb" and "Adding a Breadcrumb Region to a Page"
Parent topic: Creating a Breadcrumb Manually
Creating Breadcrumbs as Shared Components
To create breadcrumbs from the Shared Components page:
See Also:
Parent topic: Creating a Breadcrumb Manually
Creating a Breadcrumb Region Using the Create Breadcrumb Wizard
To create a breadcrumb region in Page Designer:
Parent topic: Creating a Breadcrumb Manually
Adding a Breadcrumb Region to a Page
To add a breadcrumb region to a page:
Repeat these procedures for each page where you would like to add breadcrumb navigation.
Parent topic: Creating a Breadcrumb Manually
Adding Entries to a Breadcrumb
To add entries to a breadcrumb:
- Navigate to the Breadcrumbs page:
- Select a breadcrumb to which to add entries.
- Click Create Breadcrumb Entry.
- Under Breadcrumb, select the page where this breadcrumb entry displays.
- Under Entry:
- Sequence - Indicate the order in which breadcrumb entries appear. The sequence determines the order of evaluation.
- Parent Entry - Identify the parent of this entry. Any given breadcrumb should have only one root node, identified as an item with no parent ID.
- Short Name - Identify the short name of this breadcrumb entry. Both the short and long names can be referenced from the breadcrumb template.
- Long Name - Identify the long name of this breadcrumb entry. Both the short and long names can be referenced from the breadcrumb template.
- Under Target, specify the target location:
- For Conditions:
- Condition Type - Select a condition type from the list. This condition must be met in order for this component to be rendered or processed.
- Enter an expression in the fields provided.
- For Authorization, optionally select an authorization scheme. This authorization scheme must evaluate to TRUE in order for this component to be rendered or otherwise processed.
- For Configuration, select a build option for this component. Build options are predefined settings that determine whether or not components within an application are enabled.
- Click Create Breadcrumb Entry.
Repeat these procedures for each breadcrumb entry you create.
Parent topic: Creating a Breadcrumb Manually
About Creating Dynamic Breadcrumbs
To give users more exact context, you can include session state in breadcrumbs, making your breadcrumbs dynamic. For example, suppose a page in your application displays a list of orders for a particular company and you want to include the following breadcrumb:
Home > Orders > Orders for ACME Inc
In this example, ACME Inc
not only indicates the page a user is on but also the navigation path. The Application Express engine stores the value of ACME Inc. in session state.
To create this type of dynamic menu, you must include a reference to a session state item in the breadcrumb's short name or long name. For example:
&COMPANY_NAME.
Parent topic: Creating a Breadcrumb Manually
Editing Breadcrumbs
Once you create a breadcrumb, you can edit it on the Breadcrumbs page.
To edit a breadcrumb:
See Also:
Parent topic: Creating Breadcrumbs
Reparenting Breadcrumb Entries
You can select a new parent for selected breadcrumb entries on the Reparent Entries page.
To reparent breadcrumb entries:
Parent topic: Creating Breadcrumbs
Deleting Unused Breadcrumb Entries
To delete unused breadcrumb entries:
Parent topic: Creating Breadcrumbs
Accessing Breadcrumb Reports
You can view the Breadcrumb Hierarchy, Grid Edit Breadcrumb, Breadcrumb Exceptions, Breadcrumb Utilization and Breadcrumb History reports by clicking the appropriate tab at the top of the Breadcrumbs page.
Note:
These reports only appear after you create a breadcrumb.
To view Breadcrumb reports:
You can change the appearance of the page by using the Search bar at the top of the page.
Parent topic: Creating Breadcrumbs