Building an OmniPortlet Using the HTML Layout

5 Creating Content-Based Portlets with Web Clipping 5-1 5 Creating Content-Based Portlets with Web Clipping Web Clipping is a browser-based declarative tool that enables you to integrate any Web application with Oracle Portal. It is designed to give you quick integration by leveraging the Web applications existing user interface. Web Clipping has been implemented as a Web provider using the Oracle Portal Developer Kit, which is a component of Oracle Portal. With Web Clipping, you can collect Web content into portlets in a single centralized Web page. You can use Web Clipping to consolidate content from Web sites scattered throughout a large organization. This chapter contains the following sections: ■ Section 5.1, What Is Web Clipping? ■ Section 5.2, Adding Web Page Content to a Portal Page ■ Section 5.3, Integrating Authenticated Web Content Using Single Sign-On ■ Section 5.4, Adding a Web Clipping That Users Can Personalize ■ Section 5.5, Using Web Clipping Open Transport API ■ Section 5.6, Migrating from URL-Based Portlets ■ Section 5.7, Current Limitations for Web Clipping 5.1 What Is Web Clipping? Web Clipping allows clipping of an entire Web page or a portion of it and reusing it as a portlet. Basic and HTML-form-based sites may be clipped. Use Web Clipping when you want to copy content from an existing Web page and expose it in your portal as a portlet. The Web Clipping portlet supports the following: Note: Web Clipping is provided with Oracle Portal 11g Release 1 11.1.1 and is also available as a download with the Oracle Portal Developer Kit. In Oracle Portal, you can add a Web Clipping portlet from the Oracle Portal Repository in the Portlet Builders folder. If youve downloaded Web Clipping as part of the Oracle Portal Developer Kit, you must register it before you can use it. To learn more about registering a Web provider, see Oracle Fusion Middleware Administrators Guide for Oracle Portal. You can then add an Web Clipping portlet to any portal page. 5-2 Oracle Fusion Middleware Developers Guide for Oracle Portal ■ Navigation through various styles of login mechanisms, including form- and JavaScript-based submission and HTTP Basic and Digest Authentication with cookie-based session management. ■ Fuzzy matching of clippings, meaning that if a Web clipping gets reordered within the source page or if its character font, size, or style changes, it will still be identified correctly by the Web Clipping engine and delivered as the portlet content. ■ Reuse of a wide range of Web content, including basic support of pages written with HTML 4.0.1, JavaScript, applets, and plug-in enabled content, retrieved through HTTP GET and POST form submission. ■ Personalization, enabling page designers to expose input parameters that page viewers can modify when they personalize the portlet. These parameters can be exposed as public parameters that a page designer can map as Oracle Portal page parameters. This feature enables end users to obtain personalized clippings. ■ Integrated authenticated Web content through Single Sign-On, including integration with external applications, which enables you to leverage Oracle Application Server Single Sign-On and to clip content from authenticated external Web sites. ■ Inline rendering, enabling you to set up Web Clipping portlets to display links within the context of the portlet. As a result, when a user clicks a link in the Web Clipping portlet, the results display within the same portlet. You can use this feature with internal and external Web sites. ■ Proxy authentication, including support for global proxy authentication and per-user authentication. You can specify proxy server authentication details including type Basic or Digest and realm, through the Web Clipping Provider Test page. In addition, you can specify one of the following schemes for entering user credentials: – All users automatically log in using a user name and password you provide. – All users will need to log in using a user name and password they provide. – All public users not authenticated into Portal automatically log in using a user name and password you provide, while valid users authenticated into Portal will need to log in using a user name and password they provide. See the Oracle Fusion Middleware Administrators Guide for Oracle Portal for more information. ■ Migration from URL-based portlets, enabling you to migrate your URL-based portlets to Web Clipping. See Section 5.6, Migrating from URL-Based Portlets for more information. ■ Navigation and clipping of HTTPS-based external Web sites, if appropriate server certificates are acquired. ■ Open Transport API for customizing authentication mechanisms to clipped sites . By default, Web Clipping provider supports only HTTP challenge-based authentication methods like Basic and Digest, and form submission logins. To support custom authentication methods, like Kerberos proxy authentication, users can use the Web Clipping Transport API. See Section 5.5, Using Web Clipping Open Transport API for more information. ■ Clipping of page content from HTML 4.0.1 pages, including the following: – Clipping of applet, body, div, embed, img, object, ol, span, table, and ul tagged content Creating Content-Based Portlets with Web Clipping 5-3 – Preservation of head styles and fonts, and Cascading Style Sheets CSS – UTF-8 compliant character sets – Navigation through hyperlinks HTTP GET, form submissions HTTP POST, frames, and URL redirection ■ National Language Sets NLS in URLs and URL parameters. See Section 5.7, Current Limitations for Web Clipping for information about how Web Clipping determines the character set of clipped content. By default, all Web clipping definitions are stored persistently in the Oracle Fusion Middleware infrastructure database. Any secure information, such as passwords, are stored in encrypted form, according to the Data Encryption Standard DES, using Oracle encryption technology.

5.2 Adding Web Page Content to a Portal Page

To add Web page content to a portal page, follow the steps described in the following sections: ■ Section 5.2.1, Adding a Web Clipping Portlet to a Page ■ Section 5.2.2, Selecting a Section of a Web Page to Display in the Web Clipping Portlet ■ Section 5.2.3, Setting Web Clipping Portlet Properties

5.2.1 Adding a Web Clipping Portlet to a Page

To add a Web Clipping portlet to an Oracle Portal page, perform the following steps:

1. Navigate to the Page Groups portlet. By default, the Page Groups portlet is located

on the Build tab of the Portal Builder page. 2. In the Layout Appearance section, for Pages, click Browse. 3. Figure 5–1 shows the Page Groups tab with the list of pages. For the page to which you want to add the Web Clipping portlet, click Edit in the Actions column. Figure 5–1 Selecting a Page The page you want to edit is displayed.