Defining URL Rewrite Rules for a Page Group

Working with Page Groups 4-23 For more information about parameters and events, see Chapter 22, Using Parameters and Events . When a page group is created, parameters and events are enabled by default. When they are enabled, page designers can add parameters to pages in a selected page group and use the portlet parameters and events that are associated with the portlets placed on pages in the page group. When they are disabled, the use of parameters and events is not allowed, and none of the tabs and fields associated with them display in the user interface. To enable or disable parameters and events in a page group: 1. Log in to Oracle Portal.

2. Click the Build tab to bring it forward.

3. From the Page Groups portlet Work In drop-down list, select the page group.

By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

4. Click the Configure link.

5. Click the Configure tab to bring it forward.

6. In the Parameters and Events section, click the Edit link.

7. On the resulting page: ■ Select Enable Parameters and Events to enable the use of parameters and events in the current page group. ■ Clear Enable Parameters and Events to disable the use of parameters and events in the current page group.

8. Click OK to return to the Configure tab.

9. Click Close.

4.5.9 Enabling JavaServer Page Access to a Page Group

To make JavaServer Pages JSPs more useful within your portal, you may wish to add portlets to them. Before you can add portlets to JSPs, you must first enable JSP access to the JSP’s page group. Additionally, to use Oracle Portal portlets, you must publish the portlets externally. An externally published portlet is a portlet that has been explicitly made available for users to add to their JSPs. Finally, you reference the portlet by the name you gave it when you published it externally. Reference externally published portlets using JSP tags, such as portal:showPortlet. This section provides information on enabling JSP access to a page group and publishing portlets externally. It contains the following subsections: ■ Section 4.5.9.1, Enabling JSP Access ■ Section 4.5.9.2, Publishing a Portlet Externally ■ Section 4.5.9.3, Additional JSP Information For information about adding portlets to JSPs, including using Oracle JSP tags, see Integrating Java Server Pages with Oracle Portal, on the Oracle Technology Network: http:www.oracle.comtechnologyproductsiasportalpdfpd_ jsps_10g.pdf 4-24 Oracle Fusion Middleware Users Guide for Oracle Portal

4.5.9.1 Enabling JSP Access

To enable JavaServer Page access to a page group:

1. Log in to Oracle Portal.

2. Click the Build tab to bring it forward.

3. From the Page Groups portlet Work In drop-down list, select the page group.

By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

4. Click the Configure link.

5. Click the Configure tab to bring it forward.

6. In the JSP Access section, click the Edit link.

7. Select the Allow External Access check box.

This is required for both internal and external JSPs.

8. In the Access Key field, enter a text string to provide security between the page

group and the JSPs. The access key can contain up to 200 alphanumeric characters A to Z, a to z, 0 to 9. Do not use spaces, the underscore character _, or other special characters. An Access Key is required for both internal and external JSPs. For your external JSPs to access the page group, you will need to specify this key in the configuration file you create to support your external JSPs. When a JSP is executed, if it includes any externally published portlets, the access key in its configuration file is compared against the access key of the page group. If the keys match, the portlets are displayed.

9. Click OK to return to the Configure tab.

10. Click Close.

4.5.9.2 Publishing a Portlet Externally

Before you can publish a portlet externally, you must first enable JSP access in the page group. Follow the preceding set of steps before you publish a portlet externally. To publish a portlet externally: 1. Log in to Oracle Portal.

2. Click the Build tab to bring it forward.

3. From the Page Groups portlet Work In drop-down list, select the page group.

By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

4. Click the Browse link next to the selected page group.

This opens the Portal Navigator.

5. Click the Externally Published Portlets link.

If you do not see this link, you may not have enabled the access of JSPs to the page group. See Section 4.5.9.1, Enabling JSP Access for more information.

6. Click the Externally Published Portlet link next to Create New.

7. On the resulting page, enter a name for the portlet in the Portlet Name field.