Create Navigation Item

You can add several different item types to a portal's navigation. Mostly, portal navigation provides links to portal pages, but it can also include documents, external web sites, portlets, and task flows.

You can specify various properties and display options for non-page navigation items (including page links) to determine their appearance and behavior when the portal navigation is rendered. The options available depend on the type of item.

To set properties for a non-page portal navigation item:

Select the item in the left navigation pane.

On the Target tab, enter or modify properties for the item.

Tip:

Click the Expression Editor icon icon next to a property field to select and open the Expression Language (EL) Editor.

Table 6-1 Properties for Specific Portal Navigation Items

Property	Applies to	Description
ID	All item types	Enter a unique ID for the item. This property is automatically populated with a generated ID, for example, `newcontentlink`. but as it is used to create the URL to access the node in the portal navigation, you may want to change it to something more descriptive. The ID must be unique within the portal navigation. The first character must be either an uppercase or lowercase letter or the underscore character (`_`). Subsequent characters can be any alphanumeric character or a dash (`-`), period (`.`), or underscore (`_`). If the item is at the top level of the portal navigation, the ID must not be `wc_navtitle` or `wcnav_externalId`. These IDs are reserved.
Name	All item types	Enter a name to display for the item in the portal navigation.
Description	All item types	Enter a brief description of the item.
Visible	All item types	Select to display a node for this item when the portal navigation is displayed on a page. Alternatively, you can specify an EL expression to determine under which conditions the item is included in the navigation. For example, to specify that the item should be visible only to users with the `Manager` role, use the following EL expression: #{WCSecurityContext.userInScopedRole[Manager]}
Path	Content Item Link Page Link	Enter an external URL, or click the search icon to select a target resource to include in the portal navigation. Note: For an external URL to be found valid by WebCenter Portal, the system administrator must add it to the list of valid URLs in the `valid-link-url.xml` file. See Adding a List of Valid External URLs in Administering Oracle WebCenter Portal. If an external URL is not listed in the file, the following error message appears: The URL entered is not available in the list of valid URLs. Contact your system administrator for the list of valid URLs. Note: In the Select dialog, the Select button becomes active only when you select an item that can be included in the portal navigation.
Content Presenter Template	Content Item	Select the Content Presenter display template to use to render the document when it is selected in the navigation.
Hide Top-Level Folder	Content Query Pages Query	Select to display the results of the query or reference directly rather than displaying them under a folder.
Page Template	Content Item Link Page Link Pages Query	Select the page template to use to display the item when it is selected in the portal navigation. Select [system default] to use the portal or application default page template.
Query String	Content Query	Enter the query criteria to identify the content to include in the portal navigation, for example: SELECT * FROM cmis:document WHERE cmis:name LIKE 'Foo%'
Find Pages in	Pages Query	Select: Home Portal to include the Home portal and all its pages in the portal navigation. Portal to add the Home page of a specific portal and all its other pages to the portal navigation. Leave blank to specify the current portal, enter the name of a different portal, or click the Select Portal icon to select from all available portals. In the Select Portal dialog, you can filter the list of portals to those that you have joined, those that you moderate, or those that are public. Path to add a specific page and all its subpages to the portal navigation. Enter the path of the page, or click the Select Page icon to select from all available pages.
Page Style	Pages Query	Select the style of page to include in the portal navigation. For example, select Wiki to add only pages that use the Wiki page style to the portal navigation. Select [system default] to display all pages, regardless of style.
Excluded Page Styles	Pages Query	Enter the paths of one or more page styles, separated by commas or spaces, to exclude from the page query. For example: /oracle/webcenter/siteresources/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/ pageStyle/gsr1b60e8a7_2e23_48ff_9571_31ede592de1a/TemplateWiki.jspx, /oracle/webcenter/siteresources/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/ pageStyle/gsr1b60e8a7_2e23_48ff_9571_31ede592de1b/TemplateBlog.jspx Tip: You can find the path of a page style by selecting it on the Assets page and choosing Show Properties from the Actions menu.
Visibility	Pages Query	Select: Show all items to expose in the portal navigation every page in the results of the query, regardless of their individual Visibility property setting. Show only visible items to filter the results of the query to expose in the portal navigation only those pages whose individual Visibility property is selected. Show all but visible items to filter the results to the query to expose in the portal navigation only those pages whose individual Visibility property is deselected.

On the Options tab, set the navigation display options for the item.

Table 6-2 Navigation Item Display Options

Option	Description
Access Key	Enter a key mnemonic (single character) that can be used to access the navigation item without using the mouse.
Icon URI	Enter a path and file name of an image to use to represent the item in the portal navigation.
Search Keywords	Enter keywords to facilitate searching of the navigation item.
Tool Tip	Enter brief descriptive text to display when users hover the mouse over the item in the portal navigation.
External ID	Enter an ID to enable a direct reference to the item from a static link in the page. Navigation items with this attribute defined can be accessed using `/faces/wcnav_externalId/externalId` from an `af:goLink component` in a page or by using `/wcnav_externalId/externalId` from an External Link navigation item in the portal navigation. The alternative is to access the node by its hierarchy, which is faster, but may change as the application develops. Tip: To directly access a node for a particular portal, you must specify the portal by setting the `wc.contextURL` parameter, for example: /faces/wcnav_externalId/myNavigationItem?wc.contextURL=/spaces/myProjectSpace Depending on where you are using the link, you may need to encode the URL parameters, for example, if the External ID contains spaces or special characters, such as `%2Fspaces%2FmyProjectSpace`.
Open Link in	Select where to display the item when it is selected. The options available depend on the type of navigation item. Note: Popups are not supported for pages.
Redirect	For External Link navigation items only Select to redirect the URL specified for the external link. If you do not select this option, then the URL is rendered within the current page template.
New Attribute Name	Enter the name of an attribute that has been defined for the item but not exposed in the dialog. You can also select an attribute from the drop-down list. You can also create your own attributes that can then be referenced in page templates to render the item.
New Attribute Value	Enter a value for the attribute specified in the New Attribute Name field, and click Add. Tip: To delete an attribute, clear the attribute value and click Save.

On the Parameters tab, enter values for any parameters supported by the item, or add new parameters by entering values in the New Parameter Name and New Parameter Value fields.

Tip:

To delete a parameter, clear the parameter value and click Save.