22.5 Setting Up Events on a Page

An event is something that happens when a link or button is clicked in a portlet. A portlet's events are specified in the file provider.xml.

You can set up events only on Standard or Mobile pages or custom pages that are based on the Standard page type. You can also set up events on Portal Templates.

To set up events on a page, or a Portal Template:

1. Go to the page or template where you will set up events.

2. Switch to Edit mode.

3. Click the Properties link next to Page (or Template) in the page toolbar.

   Be sure to click the link for the page (or template) rather than the page group.

4. On the Properties page, click the Events tab to bring it forward.

   For page groups, parameters and events are enabled by default. If you cannot see the Events tab, the Enable Parameters and Events page group setting has been disabled. For more information, see Chapter 4, "Working with Page Groups".

5. Click the name of the portlet you will work with.

   If you want to show the events for all the portlets on the page, click Expand All; however, if a portlet does not have any events, you cannot expand it in the list.

6. Click the event for which you will specify an action.

7. Select:

   • Go to Page to display a particular page when the event occurs.

     Click the Browse icon and select a page to display from the list provided.

   • Redisplay Page to refresh the page when the event occurs.

   If you want to refresh the current page with new parameter values so they can be passed with an event, choose Go to Page and then choose the name of the current page. If you choose Redisplay Page, the current page is not refreshed with new parameter values (if there are any).

8. If you selected Go to Page in the previous step, the Page Input section lists any page parameters that are defined for the page. For each page parameter:

   1. From the drop-down list, choose:

      Null if you do not want to provide a value for the page parameter.

      Event Output to pass the value of one of the portlet event output parameters to the page parameter when the event occurs.

      System Variable to pass the value of a system variable to the page parameter when the event occurs; for example, USER_NAME.

      Constant to pass a specific value to the page parameter when the event occurs.

   2. In the value field or list, choose the event output or system variable whose value you want to pass to the page parameter, or enter a constant value.

9. Click OK to save your changes and return to the page or template.

For information on adding events to your portlets, see the see the Oracle Fusion Middleware Developer's Guide for Oracle Portal available on the Oracle Portal documentation page of the Oracle Technology Network at http://www.oracle.com/technology/products/ias/portal/documentation.html.