Enabling and Disabling Parameters and Events for a Page Group

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.

Working with Page Groups 4-25 This name is used within JSPs to identify which portlet to display. The name must be unique within the page group and can contain up to 200 characters. The name must begin with an alphabetic character A to Z, a to z, and can contain only alphanumeric characters A to Z, a to z, 0 to 9 and the underscore _ character. Do not use spaces or other special characters.

8. Click the Select Portlet icon, and select the portlet you will use in a JSP.

Clicking the Select Portlet icon takes you into the Portlet Repository. You can drill down through the repository hierarchy to locate the portlet you will use. Once you click the listed portlet, the task is complete. The portlet is published for use with JSPs, and you are returned to the Portal Navigator.

9. Click OK.

4.5.9.3 Additional JSP Information

You can create two types of JSPs for use with Oracle Portal: ■ Internal JSPs are created within Oracle Portal. Internal JSPs are quick and easy to set up and manage. You create them using the standard page wizards. Internal JSPs are automatically stored in the Oracle Portal system, and are managed and secured by Oracle Portal. For more information, see Section 6.6, Creating a JavaServer Page JSP . ■ External JSPs are created outside Oracle Portal using a text editor or other external tool. You store external JSPs outside of Oracle Portal. Oracle Portal does not provide any file management or security for external JSPs. There are additional requirements for having Oracle Portal accept and display external JSPs in a page group. You must create a configuration file and install it in the Oracle Portal environment, and modify the server to allow the external JSPs to log in to Oracle Portal. For more information, see the Oracle Fusion Middleware Administrators Guide for Oracle Portal. In general, internal JSPs are much simpler to create and use. External JSPs offer more flexibility, are easier to modify, and usually run faster than internal JSPs. Whether you are using external or internal JSPs, a JSP must be associated with a page group. That page group must be enabled to allow JSP access.

4.6 Sharing Objects Across Page Groups

In most cases, when you create an object within a page group, you can use that object only within that page group. If you want to share an object across page groups, you must either create it in the Shared Objects page group or move it from its page group to the Shared Objects page group. This section describes the Shared Objects page group and explains how to move content to it from other page groups. It contains the following subsections: ■ Section 4.6.1, Understanding the Shared Objects Page Group ■ Section 4.6.2, Moving Objects to the Shared Objects Page Group

4.6.1 Understanding the Shared Objects Page Group

The Shared Objects page group is a page group that contains objects that can be shared across a portal’s page groups. The types of objects you can share include attributes, item types, page types, categories, perspectives, templates, navigation pages, and styles. You can move most