Edit Defaults mode The OmniPortlet Wizard

Creating Portlets with OmniPortlet 3-21

3.3 Parameters and Events

Out of the box, OmniPortlet can receive up to five parameters and raise up to three events. Each of the events can send one or more parameters. For example, you can set up a chart that displays the employees in a department. When the user clicks one piece of the chart for example, a department name, an event is raised that sends a parameter to the page. The page may then pass a parameter to all the portlets on that page that display information about the employees. Then, all the portlets on the page display information about the employees in the selected department. To set up parameters and events, you must first enable the page group to accept parameters and events. In Oracle Portal, parameters and events are enabled by default. Then, you set up each portlet to accept the necessary parameters, and raise the required events. After youve set up the portlet parameters, you can link the portlets together by setting up the page-level parameters and events.

3.3.1 Portlet Parameters and Events

Out of the box, you can define up to five portlet parameters for an OmniPortlet. You can define parameters in the following places: ■ On the Source tab of the wizard when you define the OmniPortlet ■ On the Source tab when you select Edit Defaults for the OmniPortlet Figure 3–28 shows the Portlet Parameters section on the Source tab. Figure 3–28 Source Tab: Portlet Parameters Section Parameter values determine what data is displayed in the portlet. You can also use a parameter to pass a value in a URL or to embed a value in the portlet text. You can set up each OmniPortlet to raise up to three events. Each event can pass up to three parameters. Each parameter can be a portlet parameter, such as Param1, or a data Note: To learn how to use parameters and events with OmniPortlet, follow the steps in Chapter 4, Building Example Portlets with OmniPortlet . If you are comfortable with the provider.xml file, you can add more parameters and events by editing the file. Note: You can learn more about portlet parameters in the online Help, which you can access by clicking the Help link on the Source tab in the OmniPortlet Wizard. The online Help describes portlet parameters in detail, and how to set them up for your OmniPortlet. You can also refer to Oracle Fusion Middleware Users Guide for Oracle Portal. 3-22 Oracle Fusion Middleware Developers Guide for Oracle Portal source column, such as Department_No. You set up events on the Events tab in the Edit Defaults mode of OmniPortlet