6.6 Creating a JavaServer Page (JSP)

JavaServer Pages (JSPs) are HTML pages with special tags and embedded Java code that is executed on the Web or the application server. JSPs provide dynamic functionality to HTML pages.

In addition to the inherent virtues of a JSP, you have the added benefit of Oracle Portal caching and security features, which can be applied to the JSPs you create through your portal.

To create JSPs in Oracle Portal, the page group must be configured to allow JSP access, and the JSP page type must be included in the Page Group's list of available page types. For more information, see Section 4.5.9, "Enabling JavaServer Page Access to a Page Group" and Chapter 5, "Making a Page Type Available to a Page Group".

This section describes two ways to create JSPs through the Oracle Portal user interface:

More information on Portal Center
You can also create JSPs for use in Oracle Portal outside the Portal user interface, for example with Oracle JDeveloper. For more information, see the Oracle JDeveloper page on the Oracle Technology Network, http://otn.oracle.com/products/jdev/content.html.

6.6.1 Creating a JSP Through the Page Creation Wizard

To create a JSP through the Page Creation Wizard:

  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 a page group to own the JSP.

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

  4. In the Layout & Appearance section, click the Create link next to the Pages heading.

    If the page will be a sub-page of an existing page (rather than of the page group's root page), follow the steps outlined in Section 6.3, "Creating a Sub-Page". Then return to Step 5 in this section.

  5. On the resulting page, select JSP from the Page Type list.

  6. In the Display Name field, enter a Display Name for the page.

    Use up to 256 characters of any kind. The Display Name identifies the page in the Page Groups portlet and the Portal Navigator.

    Note:

    In the Oracle Portal user interface, an asterisk (*) indicates a field that requires a value.

    For a summary of the rules governing the naming of objects in Oracle Portal, see Appendix D, "Object Naming Rules in Oracle Portal".

  7. In the File Name field under JSP Source, enter the location and file name of the JSP to execute when users view the page.

    You can also enter a JAR or WAR file in this field. Alternatively, click Browse to locate and select the file.

  8. In the Initial JSP File field under Initial JSP File for JAR or WAR Files, enter the name of the JSP file to execute when the user first views the page.

    Do this only if you uploaded a JAR or WAR file in the previous step.

  9. Click Create.

  10. After you have created your page you may want to either create another page or edit the properties of the newly created page to add more detail.

    Note:

    For information on editing page properties, see Section 6.9, "Editing Page Properties.".

6.6.2 Creating a JSP By Copying Another Page

Note:

Only Standard pages or custom pages based on the Standard page type can be copied as a JSP.

To create a JSP by copying an existing page:

  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 that owns the page to be copied.

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

  4. In the Layout & Appearance section, click the Browse link next to the Pages heading.

  5. On the resulting page, click the Copy as JSP link next to the relevant page.

  6. In the Display Name field, enter a Display Name for the page.

    Use up to 256 characters of any kind. The Display Name identifies the page in the Page Groups portlet and the Portal Navigator.

    Note:

    In the Oracle Portal user interface, an asterisk (*) indicates a field that requires a value.

    For a summary of the rules governing the naming of objects in Oracle Portal, see Appendix D, "Object Naming Rules in Oracle Portal".

  7. Under Content Options, choose from:

    • Use Original Page's Portlet Instances. Select this option to use the portlets on the original JSP and to share the personalizations that were made to those portlets. If a portlet is deleted from the original page, it is also removed from the JSP that shares it.

    • Create Externally Published Portlets. Select this option to create an externally published portlet for each portlet on the original page, and then use the externally published portlets on the JSP. If you select this option, any personalizations made to the portlets on the original page are not carried over to the portlets on the JSP. For example, changes to develop-in-place portlets, such as the OmniPortlet, the Web Clipping portlet, and the HTML portlet, are lost because any changes to those portlets are regarded as personalizations.

  8. Click OK.

Note:

For information about editing page properties, see Section 6.9, "Editing Page Properties".