Portlet Parameters and Events

4 Building Example Portlets with OmniPortlet 4-1 4 Building Example Portlets with OmniPortlet This chapter shows you how to use OmniPortlet to create four portlets based on different data sources: a Web service, a spreadsheet CSV, XML, and an existing Web page. You will build these portlets based on the various built-in layouts, and will create a separate portlet based on an HTML layout. You will learn how to create and modify these portlets, as well as use page parameters and events to add interactivity to your portal page. This chapter includes the following sections: ■ Section 4.1, Adding an OmniPortlet Instance to a Portal Page ■ Section 4.2, Building an OmniPortlet Based on a Web Service ■ Section 4.3, Building an OmniPortlet Based on a Spreadsheet CSV ■ Section 4.4, Building an OmniPortlet Based on an XML Data Source ■ Section 4.5, Building an OmniPortlet Based on a Web Page Data Source ■ Section 4.6, Setting Up Portlet Parameters and Events ■ Section 4.7, Building an OmniPortlet Using the HTML Layout At the end of this chapter, you will create a page that contains four portlets, as shown in Figure 4–1 . Note: To learn more about specific pages and tabs in OmniPortlet, click the Help link in the top right corner of the wizard. The online Help describes the contents of the selected page or tab. You can also find more information about using OmniPortlet in Chapter 3, Creating Portlets with OmniPortlet. or about registering and configuring OmniPortlet with Oracle Portal in Oracle Fusion Middleware Administrators Guide for Oracle Portal. 4-2 Oracle Fusion Middleware Developers Guide for Oracle Portal Figure 4–1 Portal Page with Four OmniPortlet Examples All four of these example portlets require you to be able to connect to the Internet. If you must use a proxy server to connect to the Internet, you will need to configure the HTTP proxy settings on the OmniPortlet Provider Test page to use proxy authentication. If the OmniPortlet provider has been set up to use proxy authentication that requires your login, you can enter your user information in the Proxy Authentication section of the Source tab in the OmniPortlet wizard. For more information on proxy authentication, refer to Section 3.2.2, Source. For specific information on configuring the providers proxy settings, refer to the Oracle Fusion Middleware Administrators Guide for Oracle Portal.

4.1 Adding an OmniPortlet Instance to a Portal Page

In this section, you will learn how to add an OmniPortlet instance to your portal page. To add an OmniPortlet instance to a page, perform the following steps: 1. In the Edit mode of the page where you want to add the OmniPortlet, click the Add Portlets icon.

2. On the Add Portlets page, in the Available Portlets list, click the Portlet Builders

link.

3. Click the OmniPortlet link.

Note: The steps in this chapter assume that you are using the OmniPortlet provider that is available with Oracle Portal. If you installed the Oracle Portal Developer Kit separately, you may need to slightly modify the instructions when adding an OmniPortlet instance to the page. Instructions for registering and configuring OmniPortlet with Oracle Portal are located in Oracle Fusion Middleware Administrators Guide for Oracle Portal.