11.3 Creating Breadcrumbs

11.3.2.2.1 Creating Breadcrumbs from the Shared Components Page

To create breadcrumbs from the Shared Components page:

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 Breadcrumbs.

   The Breadcrumbs page appears.

5. Click Create Breadcrumb.

6. Enter a name and click Create.

7. Add breadcrumb entries. See "Adding Breadcrumb Entries".

11.3.2.2.2 Creating Breadcrumbs from a Page Definition

To create breadcrumbs from a Page Definition:

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

2. Access the Create Breadcrumb Wizard:

   • Tree view - Under Shared Components, right-click Breadcrumbs and click Create.

   • Component view - Under Shared Components, click the Create icon.

     The Breadcrumb page appears.

3. Under Shared Components, scroll down to Breadcrumbs and click the Create icon.

4. For Create, select Breadcrumb and click Next.

5. Enter a name and click Create.

6. Add breadcrumb entries. See "Adding Breadcrumb Entries".

11.3.2.2.3 Adding Breadcrumb Entries

To add a breadcrumb entry:

1. Navigate to the Breadcrumbs page:

   1. Navigate to the Workspace home page.

   2. Click the Application Builder icon.

   3. Select an application.

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

   5. Under Navigation, click Breadcrumbs.

      The Breadcrumbs page appears.

2. Select a breadcrumb to add entries to.

3. Click Create Breadcrumb Entry.

4. Under Breadcrumb, specify the page where this breadcrumb entry displays.

5. Under Entry:

   1. Sequence - Indicate the order in which breadcrumb entries appear. The sequence determines the order of evaluation.

   2. 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.

   3. Short Name - Specify the short name of this entry (referenced in the breadcrumb template).

   4. Long Name - Specify the long name of this entry (referenced in the breadcrumb template).

6. Under Target, specify the target location:

   1. Target is a - Select Page in this Application.

   2. 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.

   3. Request - Specify the request to be used.

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

   5. 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\).

7. To make the breadcrumb conditional:

   1. Make a selection from the Condition Type list.

   2. Enter an expression in the fields provided.

8. Under Authorization, you can specify an authorization scheme.

   This authorization scheme must evaluate to TRUE in order for this component to be rendered or otherwise processed.

9. Under Configuration, you can select a build option for this component.

   Build options are predefined settings that determine whether components within an application are enabled.

10. Click Create Breadcrumb Entry.

Repeat these procedures for each breadcrumb entry you create.

11.3.2.2.4 Adding a Breadcrumb Region

A region is an area on a page that serves as a container for content. Once you create a breadcrumb and a breadcrumb template, the next step is to create a region. Once you create a breadcrumb region, you can add a breadcrumb to a page.

To create a breadcrumb region:

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

   • Tree view - Under Page Rendering, right-click Regions and click Create.

   • Component view - Under Page Rendering, click the Create icon.

     The Create Region Wizard appears.

2. For the region type, select Breadcrumb and click Next.

3. For Breadcrumb Container Region:

   1. Region Title - Enter a title for this region.

   2. Region Template - Select a region template.

   3. Display Point - Select a Display Point.

      Regions are organized by position (or Display Point). To determine the appropriate region position, click the flashlight icon. A graphical representation appears.

   4. Sequence - Enter a number for the sequence. The sequence determines the order of evaluation.

   5. Click Next.

4. For Breadcrumb:

   1. Breadcrumb - Select the breadcrumb to be associated with this region.

   2. Breadcrumb Template - Select a template.

   3. Click Next.

5. Review the breadcrumb region information and click Next.

6. Click Finish.

Repeat these procedures for each page where you would like to add breadcrumb navigation.

11.3.2.2.5 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.