Submitting and Managing Menu Item Requests

This chapter provides an overview of Menu Item Requests feature and a list of common elements used in this chapter. This chapter also discusses how to:

Set up menu item request email notifications.
Submit and edit menu item requests.
Manage menu item requests.
Register approved menu item requests.

Understanding the Menu Item Requests Feature

Menu items are pages, websites, or files accessible from the navigation menu. PeopleSoft Enterprise Portal's Menu Item Requests feature enables portal users to contribute information to their organization's intranet by submitting a menu item request for a file attachment, managed content, a website Uniform Resource Locator (URL), or a PeopleSoft URL.

The Menu Item Requests feature contains three levels of security, which allow users to submit menu item requests, managers to approve or reject the requests, and the portal administrator to register approved requests. Security for this feature is based on the following three permission lists, which are delivered with your software:

PAPP4100.

Submit menu item requests.
PAPP4020.

Approve and manage menu item requests.
PAPP4025

Register menu item requests.

PeopleSoft also delivers user roles that are configured to perform PeopleSoft Enterprise Portal functions. The following three roles have been configured to include menu item functions:

Role	Role Description
PAPP_AUTHOR	Content Author
PAPP_NAVIGATION_MANAGER	Navigation Manager
PAPP_NAVIGATION_ADMIN	Navigation Administrator

The Menu Item Requests feature can be set up to send email notifications of status changes to menu item requests. Manager notifications are sent for newly submitted requests pending review and approval. Administrator notifications are sent for approved requests pending portal registration.

Common Elements Used in This Chapter

Status	Displays the current status of the associated request.
Content Type	Displays the content type of the associated request.
Creation Date	Displays the creation date of the request.
Created By	Displays the user ID of the person who created the request.

Setting Up Menu Item Request Email Notifications

This section discusses how to use the Request Notification component (EPPMI_NOTIFY) to set up users to receive email notification of status changes to menu item requests.

Page Used to Set Up Menu Item Request Email Notifications

Page Name	Object Name	Navigation	Usage
Menu Item Request Notification	EPPMI_NOTIFY	Portal Administration, Menu Item Requests, Request Notification	Set up menu item request email notifications.

Setting Up Menu Item Request Email Notifications

Access the Menu Item Request Notification page.

User ID

Select the ID of the user to which you want to send email notifications of menu item request status changes.

Manager

Select if the user is a navigation manager and requires notifications for newly submitted requests pending review and approval.

Administrator

Select if the user is a navigation administrator and requires notifications for approved requests pending portal registration.

Email Address

If available, the email address will default from the user profile, but can be overridden. Menu item request notifications will be sent to this address.

Submitting and Editing Menu Item Requests

This section discusses how to:

Search for menu item requests.
Submit or edit menu item requests.

Pages Used to Submit and Edit Menu item Requests

Page Name	Object Name	Navigation	Usage
Submit Menu Items	EPPMI_SUBMIT_LST	My Content, Submit Menu Items	Search for requested menu items for reviewing, deleting, or editing.
Delete Confirmation	EO_PE_DEL_CONFIRM	Click the Delete button on the Submit Menu Items page.	Confirm deletion of a requested menu item.
Edit Menu Item Request	EPPMI_ITM_EDIT	Click the Add Menu Item Request button on the Submit Menu Items page. Click a Menu Item Request link for a menu item request in Draft, Submitted, or Rework status.	Add a new menu item request, or edit an existing request in Draft, Submitted, or Rework status.
View Menu Item Request	EPPMI_ITM_VIEW	Click a Menu Item Request link for a menu item request in Rejected, Approved, or Registered status.	View an existing menu item request.

Searching for Menu Item Requests

Access the Submit Menu Items page.

Add Menu Item Request

Click to access the Edit Menu Item Request page, where you can add a new menu item request.

Search

Click to execute a menu item request search using criteria you have specified in the Status and Content Type fields. The Submit Menu Item page lists menu item requests that meet your search criteria.

Menu Item Requests

Menu Item Request

Click for a menu item request in Draft, Submitted, or Rework status to access the Edit Menu Item Request page, where you can edit all fields of the menu item request.

Click for a menu item request in Rejected, Approved, or Registered status to access the View Menu Item Request page, where you can view all fields of the menu item request.

Delete

Click to delete the associated menu item request. You will be prompted to confirm your deletion.

The Delete button displays only for menu item requests with a status of Draft, Rejected, Rework, or Submitted.

Submitting or Editing Menu Item Requests

Access the Edit Menu Item Request page.

Menu Item Request

Request Status	Displays the current status of this request. If this is a new request, the field is clear.
Email Address	If available, the email address will default from the user profile, but can be overridden. Status change notifications will be sent to this address.
Comments	Enter special instructions or additional information.

Menu Item Identifier

Menu Item Label	Enter the link text that will appear for the menu item in the portal menu.
Menu Item ID	Defaults from the menu item label, but can be changed. Special characters are removed, spaces are replaced with underscores, the defined prefix is added, and text is changed to uppercase. For example, My Submitted Item is stored as ADMN_MY_SUBMITTED_ITEM, where ADMN is the prefix as defined on the Portal Solutions Installation Options page. See Defining Portal Solutions Installation Options.
Long Description	Enter text that you want to appear as hover text for the menu item link.
Publish Date	Select the date on which you want to publish the menu item. Defaults to today's date.
Expiration Date	Select the date on which you want to discontinue the menu item. Leave this field clear if there is no expiration date for the menu item.

Menu Item Content

Menu Item Author	This value initially defaults from information available in the user profile, but can be edited.
Menu Item Type	Select the content type for the menu item. Available values include: File Attachment. Managed Content. PeopleSoft URL. Web Site URL. Note. Remaining fields discussed in this section are based on the content type selected.
Add Attachment	Click to access a page where you can browse for the file for which you want to submit a menu item request. This button displays when the Content Type field is set to File Attachment.
File Name	The name of the selected file attachment displays as a link to the contents of the file. This field displays when the Content Type field is set to File Attachment.
Delete Attachment	Click to delete the file attachment from the menu item request. This field displays when a file attachment has been added to a menu item request.
Date Added	Displays the date and time at which the file attachment was added to the menu item request. This field displays when a file attachment has been added to a menu item request.
Select Content	Click to access the Select Managed Content page, where you can access a list of content that is available for selection. Only approved content that is in a publishable category and for which you have viewer privileges is listed. Click the Content Title link to select the content and return to the Edit Menu Item Request page. See Importing Managed Content. This field displays when the Content Type field is set to Managed Content.
Content Title	The name of the selected content displays as a link to the content. This field displays when the Content Type field is set to Managed Content.
Re-Select Content	Click to access the Select Managed Content page, where you can select different managed content for your menu item request. This field displays when managed content has been added to a menu item request.
Content Type	Displays the content type. File Attachment, Text, or HTML, for example. This field displays when managed content has been added to a menu item request.
Content ID	Displays the identifier of the content. This field displays when managed content has been added to a menu item request.
Market	Select the market for the PeopleSoft URL. This field displays when the Content Type field is set to PeopleSoft URL.
Menu Name	Enter a valid menu name for the PeopleSoft URL. This field displays when the Content Type field is set to PeopleSoft URL.
Component Name	Enter a valid component name for the PeopleSoft URL. This field displays when the Content Type field is set to PeopleSoft URL.
Parameters	Enter any existing parameters for the PeopleSoft URL. For example: ?P1=value1&P2=value2&P3=value3. This field displays when the Content Type field is set to PeopleSoft URL.
URL	Enter the website URL for your menu item request. For example: http://www.peoplesoft.com. This field displays when the Content Type field is set to Web Site URL.

Search Key Words

Use the Search Key Words group box to enter up to three key words. Entering a keyword creates an attribute on a registered menu item with a Keyword parameter that contains the keyword value you enter.

The keywords you enter for the menu item are picked up in a search of the portal registry. Portal registry searches use the following criteria: Label, Long Description, and Attribute Values (with the attribute parameter of Keyword).

Save as Draft

Click to save your request in draft mode. Use this option when you want to save the menu item request, but are not ready to submit it for review and approval.

Note. No email notifications are triggered for requests with a status of Draft.

Submit Menu Item

Click to submit your menu item request for review and approval.

This action triggers an email notification to the submitter with a link to the Submit Menu Item page. The submitted status is defaulted from the email.

This action also triggers an email notification to the designated navigation manager with a link to the Manage Menu Item Requests page. The email URL sets the filter to display only submitted items.

Managing Menu Item Requests

This section discusses how to:

Approve menu item requests.
Update menu item requests.
Delete rejected menu item requests.

Pages Used to Manage Menu Item Requests

Page Name	Object Name	Navigation	Usage
Manage Menu Item Requests	EPPMI_MANAGE_LST	Portal Administration, Menu Item Requests, Manage Requests	Approve or reject submitted menu item requests.
Edit Menu Item Request	EPPMI_ITM_EDIT_SEC	Click the Menu Item Request link for a menu item request in Rejected, Submitted, Rework, or Approved status on the Manage Menu Item Requests page.	Edit a menu item request.
View Menu Item Request	EPPMI_ITM_VIEW_SEC	Click a Menu Item Request link for a menu item request in Registered status on the Manage Menu Item Requests page.	View the details of a menu item request.
Delete Menu Item Requests	EPPMI_DEL_LST	Portal Administration, Menu Item Requests, Delete Requests	Delete rejected menu item requests.

Approving Menu Item Requests

Access the Manage Menu Item Requests page.

Menu Item Requests

Menu Item Request

Click the Menu Item Request link to access the Edit Menu Item Request page, where you can access and edit information about the selected menu item request.

See Updating Menu Item Requests.

Publish Date

Displays the date on which the submitter wants to publish the requested menu item.

Save Menu Items

Click to save changes made on the Edit Menu Item Request page.

Warning! Although you clicked the OK button on the Edit Menu Item Request page to update the request, your changes will not be saved until you click the Save Menu Items button.

This action triggers an email notification to the submitter with a link to the Submit Menu Item page.

Note. Requests with a status of Rework can be resubmitted, deleted, or saved as draft. Requests with a status of Rejected can be viewed or deleted. Requests with a status of Approved can be viewed.

Approved menu item requests will also trigger an email notification to the navigation administrator with a link to the Administer Menu Item Requests page.

Updating Menu Item Requests

Access the Edit Menu Item Request page.

Menu Item Request

Request Status

Update the status of the request based on your review and updates. Available values include:

Approved.

Rejected.

Rework.

Submitted.

Email Address

Displays the email address of the person who submitted this request.

Comments

Add any comments based on your review of the menu item request. For example, you can enter details about the changes you made to specific fields, as well as the reasons why the menu item request was rejected or needs to be reworked.

Menu Item Identifier

Changes can be made to all fields in this section.

See Submitting or Editing Menu Item Requests.

Menu Item Content

Click the Content Title or File Attachment link to view the content.

Search Key Words

Changes can be made to all fields in this section.

See Submitting or Editing Menu Item Requests.

Click to update your changes to the menu item request and return to the Manage Menu Item Requests page.

Warning! You must click the Save Menu Items button on the Manage Menu Item Requests page to save any changes you made on this page.

Return to Menu Item List

Click to return to the Manage Menu Item Requests page.

Warning! Any changes you made on this page will not be saved.

Go to Administer Requests

After saving your changes by clicking the Save Menu Items button on the Manage Menu Item Requests page, you can return to this page and click this link to access the Administer Menu Item Requests page, where you can register the menu item, once it has been approved.

Note. This link displays only if you have been granted permission to register menu item requests.

See Registering Approved Menu Item Requests.

Deleting Rejected Menu Item Requests

Access the Delete Menu Item Requests page.

Only menu item requests with a status of Rejected are available for deletion.

Click the Delete button to delete the associated menu item request.

Click the Delete All button to delete all menu item requests.

You will be prompted to confirm your deletion.

Registering Approved Menu Item Requests

This section discusses how to:

Register approved menu item requests.
Define the menu item registry entry.
Select a menu item folder.
View menu item registry details

Pages Used to Register Approved Menu Item Requests

Page Name	Object Name	Navigation	Usage
Administer Menu Item Requests	EPPMI_REG_LST	Portal Administration, Menu Item Requests, Register Requests	Register approved menu item requests.
Edit Menu Item Request	EPPMI_ITM_EDIT_SEC	Click the Menu Item Request link for a menu item request in Rejected, Submitted, Rework, or Approved status on the Administer Menu Item Requests page.	Access and edit details of a menu item request.
View Menu Item Request	EPPMI_ITM_VIEW_SEC	Click the Menu Item Request link for a menu item request in Registered status on the Administer Menu Item Requests page.	View menu item request details.
Define Registry	EPPMI_REG_DFN	Click the Register Item button on the Administer Menu Item Requests page.	Determine how the menu item will be rendered online, such as the site and menu folder to which it will be published.
Select Menu Folder	EPPMI_REG_FLD	Click the Select Menu Folder button on the Define Registry page.	Choose the parent folder in which you want to register the menu item.
Confirm Registry	EPPMI_REG_CNF	Click a folder link on the Select Menu Folder page.	Confirm menu item registration.
Registry Details	EPPMI_REG_VIEW	Click the Yes - Register button on the Confirm Registry page. Click the Registry Details button on the Administer Menu Item Requests page.	Review registry information for the menu item, or remove the menu item from registry.

Registering Approved Menu Item Requests

Access the Administer Menu Item Requests page.

Menu Item Request

Click for a menu item request in Rejected, Submitted, Rework, or Approved status to access the Edit Menu Item Request page.

Click for a menu item request in Registered status to access the View Menu Item Request page.

Register Item

Click to access the Define Registry page, where you can register the menu item.

This button displays for menu item requests in Approved status.

Registry Details

Click to access the Registry Details page, where you can view registry details for a menu item, or remove the menu item from the registry.

This button displays for menu item requests in Registered status.

Save Menu Items

Click to save the changes made on the Edit Menu Item Request page.

Warning! Even though you clicked OK to update the request on the Edit Menu Item page, your changes will not be saved, until you click Save Menu Items.

This action will trigger an email notification to the submitter with a link to the Submit Menu Item page.

Note. Only requests with a status of Registered have the Registry Details option available.

Defining the Menu Item Registry Entry

Access the Define Registry page.

Site Name

Select the portal or site in which you want to register the menu item. This value defaults to the current portal or site.

Node Name

This field displays when the Content Type field is set to PeopleSoft URL.

Select the database node that contains the PeopleSoft page that you want to register as a menu item. The node is used to derive the web server URL used to access the content provider database.

Select Always use local to indicate that you want to use the current portal database.

Template Name

This field displays when the Content Type field is set to PeopleSoft URL or Web Site URL.

Select a template to determine how the URL content will be displayed on the page. PeopleSoft delivers a number of standard templates, or you can design your own. PeopleSoft recommends leaving this field clear unless there is a special circumstance. Leaving this field clear, invokes the system to use the default template.

Product

Optionally, enter text to tag menu items for SQL queries against the registry tables.

Access Type

Select the type of security access you want to grant for the menu item. Available values include:

Permission. Select to indicate that you want to specify permission lists that define access rights to the menu item.

Public. Select to indicate that you want the menu item to be accessible by all users.

Author Access

This option displays when the Access Type field is set to Permission.

Select to indicate that you want the user who submitted the menu item request to have access to the menu item regardless of any other permissions that are defined for the menu item. However, if the user does not have access to the menu component, the system will issue an authorization error.

Permissions

This option displays when the Access Type field is set to Permission.

Select the permission lists that you want to have access to the menu item.

Select Menu Folder

Click to access the Select Menu Folder page, where you can choose the parent folder for the menu item.

Selecting a Menu Item Folder

Access the Select Menu Folder page.

Click the folder icons to navigate through the portal registry hierarchy. Click a folder link to select the desired folder and access the Confirm Registry page, where you can confirm the registration of the menu item.

Viewing Menu Item Registry Details

Access the Registry Details page.

Site Name

Displays the portal or site in which the menu item is registered.

Node Name

Database node that contains the PeopleSoft page.

Template Name

Determines how the menu item content is displayed on the page. A value of (Not Specified) indicates that the default template will be used to display the page.

Access Type

Valid values include:

Public. All users can access the menu item.

Permission. Only users who are associated with the selected permission list are able to access the menu item.

Remove from Registry

Click to remove the menu item from the registry.

A new page displays confirming the removal.

Go To Registry Structure & Content

Click to access the Content Ref Administration page for the menu item.

This link displays if the current user has security access to the Structure and Content component.

See Enterprise PeopleTools 8.48 PeopleBook: Internet Technology, "Administering Portals," Administering Content References

User ID	Select the ID of the user to which you want to send email notifications of menu item request status changes.
Manager	Select if the user is a navigation manager and requires notifications for newly submitted requests pending review and approval.
Administrator	Select if the user is a navigation administrator and requires notifications for approved requests pending portal registration.
Email Address	If available, the email address will default from the user profile, but can be overridden. Menu item request notifications will be sent to this address.

Add Menu Item Request	Click to access the Edit Menu Item Request page, where you can add a new menu item request.
Search	Click to execute a menu item request search using criteria you have specified in the Status and Content Type fields. The Submit Menu Item page lists menu item requests that meet your search criteria.

Menu Item Request	Click for a menu item request in Rejected, Submitted, Rework, or Approved status to access the Edit Menu Item Request page. Click for a menu item request in Registered status to access the View Menu Item Request page.
Register Item	Click to access the Define Registry page, where you can register the menu item. This button displays for menu item requests in Approved status.
Registry Details	Click to access the Registry Details page, where you can view registry details for a menu item, or remove the menu item from the registry. This button displays for menu item requests in Registered status.
Save Menu Items	Click to save the changes made on the Edit Menu Item Request page. Warning! Even though you clicked OK to update the request on the Edit Menu Item page, your changes will not be saved, until you click Save Menu Items. This action will trigger an email notification to the submitter with a link to the Submit Menu Item page. Note. Only requests with a status of Registered have the Registry Details option available.

Site Name	Select the portal or site in which you want to register the menu item. This value defaults to the current portal or site.
Node Name	This field displays when the Content Type field is set to PeopleSoft URL. Select the database node that contains the PeopleSoft page that you want to register as a menu item. The node is used to derive the web server URL used to access the content provider database. Select Always use local to indicate that you want to use the current portal database.
Template Name	This field displays when the Content Type field is set to PeopleSoft URL or Web Site URL. Select a template to determine how the URL content will be displayed on the page. PeopleSoft delivers a number of standard templates, or you can design your own. PeopleSoft recommends leaving this field clear unless there is a special circumstance. Leaving this field clear, invokes the system to use the default template.
Product	Optionally, enter text to tag menu items for SQL queries against the registry tables.
Access Type	Select the type of security access you want to grant for the menu item. Available values include: Permission. Select to indicate that you want to specify permission lists that define access rights to the menu item. Public. Select to indicate that you want the menu item to be accessible by all users.
Author Access	This option displays when the Access Type field is set to Permission. Select to indicate that you want the user who submitted the menu item request to have access to the menu item regardless of any other permissions that are defined for the menu item. However, if the user does not have access to the menu component, the system will issue an authorization error.
Permissions	This option displays when the Access Type field is set to Permission. Select the permission lists that you want to have access to the menu item.
Select Menu Folder	Click to access the Select Menu Folder page, where you can choose the parent folder for the menu item.

Site Name	Displays the portal or site in which the menu item is registered.
Node Name	Database node that contains the PeopleSoft page.
Template Name	Determines how the menu item content is displayed on the page. A value of (Not Specified) indicates that the default template will be used to display the page.
Access Type	Valid values include: Public. All users can access the menu item. Permission. Only users who are associated with the selected permission list are able to access the menu item.
Remove from Registry	Click to remove the menu item from the registry. A new page displays confirming the removal.
Go To Registry Structure & Content	Click to access the Content Ref Administration page for the menu item. This link displays if the current user has security access to the Structure and Content component. See Enterprise PeopleTools 8.48 PeopleBook: Internet Technology, "Administering Portals," Administering Content References