Creating a JSP page

JSP pages display the results of executing a Java Server Page (JSP). When you create a JSP page, you upload your JSP files to the portal. By uploading your JSPs to the portal, you can use the Oracle9iAS Portal graphical interface to easily leverage other page building features, such as page caching, security, and parameters, in your JSPs.

If you do not upload your JSPs to the portal, you can manually edit them to leverage some of these features. For information about how to do this, see Integrating Java Server Pages with Oracle9iAS Portal on the Oracle Technology Network.

To create a page, you must have at least one of the following privileges:

Portal administrator
Manage All privileges on the page group in which you want to create the page
Manage global privileges on All Pages
Create global privileges on All Pages and Manage privileges on the parent page of the new page

You can create JSP pages only if the JSP access page group setting is enabled.

To create a JSP page:

In the Navigator, click Contents next to the page group in which you want to create the page.
Click Create in the Pages row.

Tip: If you want to create the page as a sub-page of another page, click Create next to the page under which you want to create the new JSP page.
In the Page Type list, choose JSP.

Note: If JSP is not included in this list, the JSP access page group setting is not enabled, or the JSP page type has been excluded from the page group.
In the Name field, enter a name for the page.

Note: The name is used internally and for direct access URLs. The name is limited to 40 characters, and can contain any alphanumeric character (A-Z, a-z, 0-9), spaces, and the following special characters: _, -, ., (, ), ! , ; = ~ @.
In the Display Name field, enter a descriptive name for the page.

Note: The display name is limited to 40 characters.
(Optional) In the Description field, enter a description for the page. The description is displayed only when you edit the page. It does not appear to the user.

Note: The description must not exceed 2000 characters.
Select a page caching option.

Notes:
- The following caching options are available for JSP pages: Cache Page Definition Only and Cache Page Definition Only At System Level.
- Caching at the system level places a single copy of the page's structure in the system cache for all users. Consequently, all page customization options are disabled.
- For more information about page caching, see Changing how a page is cached.
Click Next.
In the File Name field, enter the path and file name of the JSP, JAR, or WAR file that you want to execute when the page is displayed. When you click Finish or Next, the file is uploaded to the database.

Tip: If you do not know the name and location of the file, click Browse to locate the file on your file system.
If you specified a JAR or WAR file in the previous step, in the Initial JSP File field, enter the name of the JSP file within the JAR or WAR file to execute when the page is displayed.

If you specified a JSP file in the previous step, leave the Initial JSP File field empty.
Click Next.
(Optional) Select Display Page To Public Users if you want everyone, including users who are not logged into the portal, to be able to view the page.
(Optional) To explicitly grant privileges to specific users or groups:
1. In the Grantee field, enter the name of the user or group that you want to allow to access this page.
  
  Tip: If you are not sure of the name of the user or group, click (for users) or (for groups), and select from the list provided.
2. In the list, choose a privilege level.
  
  Note: The order of the privileges in the list is not based on any hierarchy of privileges. For more information, see Page privileges.
3. Click Add.
  
  Tip: If you want to grant a user or group multiple privileges, for example Manage Content and Manage Style, add the user or group separately for each privilege.
Click Finish to create the page and return to the Navigator.

Note

Because Oracle Internet Directory (OID) can include multiple directory containers that use the same group names, the distinguished name (DN) is displayed next to any group that does not belong to the local Portal instance.