Page Information

Return to Portal Editor

Use the Page Information tabs to manage portal pages and other items in the portal navigation, including viewing and modifying page information, adding and deleting parameters, viewing page source code, establishing page security, and specifying additional navigation options.

Renaming a Page

If you created or have permissions to manage a portal page, you can rename the page.

Be aware that renaming a page affects all members in the portal as this action alters the page itself, not only your view. Renaming a page changes the display name for the page and the page navigation item. It does not change the page URL; any pretty URLs using the old name remain valid.

Even when page drafts are enabled, renaming a page takes effect immediately on the published page, regardless of whether or not the page has a pending draft. In other words, you do not need to publish the page draft before the new page name can be seen by page viewers.

To rename a page that you created or have permissions to manage:

1. On the Summary tab, enter a new page name in the Name field.

   The page display name and the page navigation item display the new name.

Entering or Changing a Page Description

If you created or have permissions to manage a page, you can change the description of the page. The new description is shown at the top of the page information settings.

Even when page drafts are enabled, changing a page description takes effect immediately on the published page, regardless of whether or not the page has a pending draft. In other words, you do not need to publish the page draft before the new page description can be seen by page viewers.

To enter or change the description for a page that you created or have permissions to manage:

1. On the Summary tab, enter or modify the text in the Description field. The new description is shown at the top of the page information settings.

Showing or Hiding a Page in the Portal Navigation

If you created or have permissions to manage a portal page, you can control whether or not that page is shown in the portal navigation. A page is added to the portal navigation when it is first published. If you hide a page, it is removed from the portal navigation for all portal viewers, but is still available in the portal editor to edit and manage.

To show or hide a page in the portal navigation for all viewers:

1. On the Summary tab, select the Visibility check box to display the page, or deselect the check box to hide the page in the navigation for the portal.

   Note:

   You cannot deselect the Visibility check box if the page is the only page or the only visible top level page in the portal.

   To enter an Expression Language (EL) expression that determines whether or not the page displays in the navigation, click the icon on the right, then select Expression Builder to open the Expression Language editor, and then enter an EL expression. If the expression evaluates to false, the page is not visible in the navigation. Otherwise, the page is visible in the navigation.

Setting Page Behavior for a Specific Page When No Page Variant Exists

Page variants are alternative views of an existing page for specific device groups to target specific device size and characteristics. The base page and the page variant have the same URL, security, parameters, and so on.

When using a device (such as smart phones, tablets, and desktop browsers) in a device group that does not have a page variant defined, and the device group is not the default device group for the portal, the page fallback setting determines how to render the page when it is viewed on that device. This behavior is set for all pages in a portal in the portal administration, but you can override the portal-level setting for an individual page, as described here.

This setting is honored based on the following rules:

• If the request is from a device in the default device group for the portal, then the default (base) page will be displayed no matter what is set for Page Fallback. The default setting always overrides the Page Fallback setting.

  Note:

  This means that even if there is a page variant for the device group, the default (base) page will be displayed.

• If the request is from a device that is not in the default device group for the portal, then:

  • If there is a page variant for that device group, the page variant is displayed on the device.

  • If no page variant exists for the device group, then the Page Fallback setting is used by the device:

To set the fallback behavior for a page when displayed on a device in a device group that does not have a page variant defined, and the device group is not the default device group for the portal:

1. On the Summary tab, under Devices, select the required Page Fallback setting:

   • Use portal setting to use the portal-level default setting specified on the Settings page in the portal administration.

   • Display default page to display the original base page on the device.

   • Display no page to display the Page Not Available page on the device.

Adding or Modifying Page Parameters

Page parameters allow communication between components and the pages that contain them by providing a means of storing values for passing to page components that have been configured to consume them.

For example, imagine a page that contains stock ticker and stock news components. You want the ticker and the news components to both consume the same parameter value so that they both show information for the same company.

Even when page drafts are enabled, changing page parameters takes effect immediately on the published page, regardless of whether or not the page has a pending draft. In other words, you do not need to publish the page draft before the effect of new page parameters can be seen by page viewers.

Note:

If you change a page parameter value, the new value is immediately saved. You cannot revert back to the prior value. Therefore, take note of parameter values before you change them in case you want to set them back to their original values.

To add or modify page parameters:

1. On the Parameters tab, modify existing parameters as required or add new parameters by entering values in the New Parameter Name and New Parameter Value fields.

   Note:

   A parameter name must start with an alphabet or underscore (_) character only and can contain only alphanumeric and underscore characters

   The Parameters and Display Options dialogs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the icon next to a property, then select Expression Builder to open the editor.

2. Click Add to add the new page parameter name/value pair to the page.

Viewing and Modifying Page Source Code

The Source tab for a selected page enables you to view, search, and edit the source code for the page. If there is draft for the current page, the source is for the draft. If there is no page draft, then the source is for the published page.

Even when page drafts are enabled, changing page source code takes effect immediately on the published page, regardless of whether or not the page has a pending draft. In other words, you do not need to publish the page draft before the effect of page source code changes can be seen by page viewers.

You can view and modify the source code for a page on two tabs:

• The Page tab shows the underlying JSF (.jspx) file that defines the page layout and style.

• The PageDef tab shows the .xml file that defines the parameter definitions and task flow and data control bindings for the page.

To view the source code for a page:

1. On the Source tab, click Page or PageDef at the bottom of the pane to view and modify page or page definition source code, respectively.
2. To save your changes, click Save.

   Note:

   To save any changes you make on the Source tab, you must click Save. If you navigate to another tab without clicking Save, the changes made on the Source tab are lost.

Setting Page Security

By default, the pages you create in a portal are viewable by all portal members. In the Home portal, the personal pages you create are accessible only to you and the system administrator.

You can use page access settings to enable others to work with your portal pages and personal pages, and to remove that access. When you grant Create permission on a page, those granted this permission can create subpages.

When you grant access to one of your personal pages in the Home portal to another user, they must deliberately show the page in their view. The user must take this step for each session because shared pages are not automatically shown on login.

Even when page drafts are enabled, changing page security takes effect immediately on the published page, regardless of whether or not the page has a pending draft. In other words, you do not need to publish the page draft before the effect of new page security is implemented.

You may want to open a page to many users, but limit the exposure of a particular page component. To accomplish this, you can set the component's Access properties to hide the component, or specify more granular visibility by role or user, or by using an EL expression.

To specify security settings for a page:

1. On the Security tab, select the Access Method:

   • (Default) To specify that the page should inherit access settings from the permissions established for the portal, or for the parent page (if a subpage), select Inherit Parent Security.

   • To customize access on the current page, select Override Security, and continue with the next steps.

     Note:

     If custom page permissions are specified for roles or individual users in a portal that is later used to create a new portal template, then only the custom page permissions specified for the roles (not individual users) are included in the portal template (and subsequently in a portal that is created using the portal template).

2. To modify the access permissions to users or roles listed under Role or User, select or deselect the Access check boxes, described in the following table.

   Note:

   To grant page access to the Public-User role (that is, to enable users who are not logged in to access the portal) the portal must be public. The portal cannot be private or hidden.

   Table 6-4 Page Access Privileges

   Access	User, Group, or Role Permissions
   Grant	Grant other users, groups, or roles access to the page and any subpages.
   Publish	Publish page drafts to make page updates available to portal viewers. When this permission is granted, Delete and Edit are automatically granted. If you revoke Publish permission, Delete and Edit are not automatically revoked, and therefore must be explicitly revoked as required.
   Create	Create subpages of the current page.
   Delete	Delete the page and any subpages.
   Edit	Edit the page and any subpages using the page editor. This includes adding, rearranging, and deleting content; renaming the page; and changing page properties.
   Contribute	Contribute text, images, and video to the page using contribution mode. Edit and delete any content contributed to the page. Changes made in contribution mode do not create a page draft; changes are visible immediately in the portal. Note: Do not grant users this permission if you want to enforce page drafts for all page edits, including content publishing.
   View	View the page and any subpages.

3. To grant page access permissions to selected users, groups, and application roles, click Add Users, Add Groups, or Add Roles to open the corresponding search dialog.
4. In the Search field, enter a search term or the name of the user, group, or role for whom you want to enable access, and click the Search icon.

   Note:

   In the Add Roles dialog for pages in a portal, you can add any custom roles that have been created for the portal.

5. Select a user, group, or role by clicking in its row.

   Note:

   When you select a user name, the permissions you set are granted to that specific user. When you select a group or role, the permissions you set are granted to all users who are members of that group or who are assigned that role.

6. Click OK to confirm your selections, and populate the Security tab with the selected users, group, or roles.
7. To grant page access permissions to all authenticated users (that is, to users who are logged in to WebCenter Portal), click Add Authenticated Role for Logged in User Access.

   The role authenticated-role is added under Role or User with default View access to the page.

8. To grant page access permissions to all public users (that is, users who are not logged in to WebCenter Portal) click Add Anonymous Role for Public Access.

   The role anonymous-role is added under Role or User with default View access to the page.

   Note:

   To grant page access to the anonymous-role (that is, to enable users who are not logged in to access the portal) the portal must be public. The portal cannot be private or hidden.

9. On the Security tab, set the Access permissions as desired for each user, group, or role.

   Tip:

   By default, all authenticated users and user roles that you add are granted page view access. The other access privileges must be explicitly granted.

10. If you wish to remove access to the page, select the user, group, or role from which to revoke page access, and click Delete Access.
11. To save your changes, click Save.

Setting Navigation Properties and Display Options for a Page

You can specify various properties and display options for page navigation items to determine their appearance and behavior when the portal navigation is rendered.

Even when page drafts are enabled, changing page properties takes effect immediately on the published page, regardless of whether or not the page has a pending draft. In other words, you do not need to publish the page draft before the effect of new properties are implemented.

To set navigation properties or display options for a page navigation item:

1. On the Advanced tab, specify information about the page on the Target pane, then click Save.

   Table 6-5 Page Navigation Item Settings: Target Pane

   Field	Description
   ID	Automatically populated with a generated ID. This ID is used to create the URL to access the page in the portal navigation. 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 page is at the top level of the portal navigation, the ID must not be wc_navtitle or wcnav_externalId; these IDs are reserved.
   Path	The path to the page. This value is not editable for a page created in the current portal. When adding a page link, you can enter the path to the page, or click the Select icon to browse the content repository for the page.
   Page Template	A drop-down list selection that specifies the page template to use to display the page when it is selected in the navigation. Select [system default] to use the portal or application default page template.

2. Set page navigation options on the Options pane, then click Save.

   Table 6-6 Page Navigation Item Settings: Options Pane

   Field	Description
   Access Key	A keyboard mnemonic (single character) that can be used to access the navigation item without using the mouse.
   Icon URI	The path and file name of an image to use to represent the page navigation item.
   Search Keywords	Keywords to facilitate searching for the page navigation item.
   Tool Tip	Brief descriptive text to display when users hover the mouse over the page navigation item.
   External ID	An ID to enable a direct reference to the page navigation item from a static link in a page. Navigation items with this attribute defined can be accessed using /faces/wcnav_externalId/externalId from an af:goLink component in a page or using /wcnav_externalId/externalId from an External Link navigation item. The alternative is to access the node by its hierarchy, which is faster, but may change as the application develops.
   Open Link In	A drop-down list selection that specifies the container in which to display the navigation item. Note: Opening a link in a popup is not valid for pages and large navigation items, but is useful for external links.
   New Attribute Name	The name of an attribute that has been defined for the page but not exposed on the Advanced tab. You can also select an attribute from the drop-down list.
   New Attribute Value	An optional value for the attribute specified in the New Attribute Name field. Enter a value and click Add, or click Add without specifying a value to provide the value once the field is displayed on the Options tab.

   Tip:

   An Expression Editor is available for entering custom values using Expression Language (EL) expression, allowing the values to be determined dynamically based on certain criteria. Click the icon next to a property, then select Expression Builder to open the editor.