Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle WebCenter Spaces
11g Release 1 (11.1.1.4.0)

Part Number E10149-06
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

28 Working with the Web Clipping Portlet

This chapter provides a brief description of the Web Clipping portlet and producer and explains how you can register a Web Clipping producer and use this producer to add a Web Clipping portlet to a JSP document created through Oracle JDeveloper.

This chapter includes the following sections:

28.1 What You Should Know About Web Clipping

Web Clipping is a publishing portlet that enables you to integrate any web application with your custom WebCenter portal application and with WebCenter Spaces. It is designed to give you quick integration by leveraging the existing user interface of the web application. With Web Clipping, you can consolidate content from web sites scattered throughout a large organization.

With Web Clipping, you can clip an entire web page, or a portion of it, and reuse it as a portlet. You can clip basic and HTML-form-based sites. Use Web Clipping when you want to copy content from an existing web page and expose it in your WebCenter portal application as a portlet.

Web Clipping supports the following features:

28.2 Working with the Web Clipping Portlet

This section describes how to clip content for a Web Clipping portlet and make the portlet personalizable. It includes the following subsections:

28.2.1 Adding a Web Clipping Portlet to a Page

The steps for adding a Web Clipping portlet to a page vary between a custom WebCenter portal application and the WebCenter Spaces application. For one thing, in a custom WebCenter portal application adding a portlet to a page is a design-time activity, carried out by the application developer. For information about adding a portlet to a page in a custom WebCenter portal application, see the “Creating Content-Based Portlets with Web Clipping” chapter in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

In WebCenter Spaces, portlets are added to pages at runtime—when you run the application. Portlets are available for dragging and dropping from the Oracle Composer Catalog by any user with sufficient privileges. For information about adding a portlet to a page in WebCenter Spaces, see Section 17.5.1, "Adding a Component to a Page."

Note:

In WebCenter Spaces, avoid adding a portlet to a Movable Box layout component (For information, see Section 18.2.3, "Working with the Movable Box Layout Component"). The Movable Box layout component duplicates the showDetailFrame that the portlet provides by default. Adding a portlet to a Movable Box creates an unnecessary and potentially error-prone redundancy.

28.2.2 Clipping Content for Display in the Web Clipping Portlet

Though the point at which you add a Web Clipping portlet to a page varies between custom applications and WebCenter Spaces—at design time or at runtime—Web Clipping content is defined at runtime for both scenarios.

There are two ways to clip and save web content:

  • Customize the portlet to set up a Web Clipping portlet to display content to all users

  • Personalize the portlet to set up your own, personal view of a Web Clipping portlet

Both options take you into Web Clipping Studio, where you can:

  • Browse for web content

  • Choose the exact portion of the web content to clip

  • Preview the clipped content as a portlet

  • Save the clipped content as a portlet

  • Set portlet properties and save the updated portlet information

To clip web content for display in the Web Clipping portlet:

  1. Open the Find a Web clipping page:

    • To set up a Web Clipping portlet to display content to all users, open the page in edit mode (Oracle Composer) and click the Customize icon in the portlet header.

    • To set up your own, personal view of a Web Clipping portlet, click the Personalize icon in the portlet header.

    The Find a Web clipping page opens (Figure 28-1).

    Figure 28-1 The Find a Web Clipping Page

    Find a Web clipping page
    Description of "Figure 28-1 The Find a Web Clipping Page"

    Note:

    When running a portlet that has an Edit mode, the Personalize option in the portlet header appears only to authenticated users. Unauthenticated or public users do not see the Personalize option. What this means is that, for personalization to work, some form of security must be implemented for your application.

    If you are a developer creating portlets and pages, then you may want a quick way to test the Edit mode of your portlet without creating a complete security model for your application. For information about how you can quickly add the necessary security for testing portlet personalization, see the “Configuring Basic Authentication for Testing Portlet Personalization” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

  2. In the URL Location field, enter the URL of the web page that contains or links to the content you want to clip.

  3. Click Start.

    Web Clipping Studio displays the page you specified (Figure 28-2).

    Note:

    You can clip Secure Socket Layer (SSL)-enabled web sites if certificates of those sites are added to the certificate store. Certificates of SSL-enabled web sites that use Equifax, VeriSign, or Cybertrust certificates are included in the default certificate store.

    For information about adding certificates, see the “Adding Certificates for Trusted Sites” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

    Figure 28-2 A Web Page Displayed in Web Clipping Studio

    URL location displayed in Web Clipping Studio
    Description of "Figure 28-2 A Web Page Displayed in Web Clipping Studio"

  4. If your starting web page is not the page you plan to clip, then within Web Clipping Studio browse to the content you want to clip.

    As you click hyperlinks in the web page, Web Clipping Studio records your navigation links.

    Notes:

    Only the significant browsing operations are recorded for later playback during the show mode. Any browsing operations that do not contribute to the eventual web clipping are discarded. Discarded links are not visited.

    For any web sites that require HTTP Basic or Digest Authentication, a form is displayed that requests user name and password information. This encoded authentication information is recorded as part of the browsing information.

  5. On the page that contains the content you want to clip, click the Section icon or link on the Web Clipping Studio banner (Figure 28-3).

    If you intend to clip the full web page, it is not necessary to section the page. You can clip the full page by clicking the Select icon or link instead of Section when you are on a page you want to clip.

    Figure 28-3 The Section Icon and Link in the Web Clipping Studio Banner

    Section icon and link in Web Clipping Studio
    Description of "Figure 28-3 The Section Icon and Link in the Web Clipping Studio Banner"

    Sectioning divides the target web page into its clippable sections (Figure 28-4).

    Figure 28-4 Sectioned Web Page in Web Clipping Studio

    Description of Figure 28-4 follows
    Description of "Figure 28-4 Sectioned Web Page in Web Clipping Studio"

    After you click Section, you cannot browse links in the displayed page. If you want to browse to other locations through page links, then click Unsection on the Web Clipping Studio banner. For more information about using Web Clipping, you can click the Help icon or link on any of the Web Clipping pages.

    Note:

    To adjust sectioning to encompass smaller or larger areas on the web page, use the Section Smaller and Section Larger options on the Web Clipping Studio banner. Click Section Smaller to divide the web page into more, smaller sections. For example, click Section Smaller to drill down one level of nested tables. Click Section Larger to divide the web page into fewer, larger sections.
  6. At the top-left corner of the section you want to clip, click Choose.

    You can choose only one section at a time. Web Clipping Studio displays a preview of your chosen section.

  7. If the displayed section is the clipping you want, then click Select on the Web Clipping Studio banner.

    If the displayed section is not the clipping you want, then click Unselect to return to the page containing the section. You can choose another section on the page, or click Unsection to remove sectioning, enabling you to navigate to another page.

    Note:

    Some sections may contain no data, only whitespace. For example, a web page may contain an HTML <DIV> tag that contains no text or images. If you click Choose on a section that contains no data, then Web Clipping displays a preview, but the preview correctly shows only whitespace. In this case, click Unselect on the preview page to return to the sectioned page. Then, select a section containing data.

    Once you have made your selection, the Web Clipping Studio displays the Find a Web clipping page with the selected web clipping's properties.

  8. Adjust the clipping's property values as necessary:

    • URL Rewriting—Controls the behavior of links embedded in the clipped content.

      Select from:

      • None—To specify that link targets display on a new browser tab.

      • Inline—To specify that link targets display inside the portlet. If you have integrated with an external application or are logged into the clipped site, and if you choose Inline for URL Rewriting, then the session is maintained to the clipped site while browsing.

        Note:

        The URL Rewriting option is available only when you customize a portlet. This option is not available when you personalize a portlet.
    • Title—A title to display in the portlet header.

    • Description—A description of the clipping. The description is not displayed in the portlet.

    • Time Out (seconds)—The number of seconds to allow for the portlet to render before it times out.

    • Expires (minutes)—The number of minutes before cached portlet content expires. Once cached content expires, the next time the portlet is refreshed—either by a browser refresh or by clicking the Refresh link in the portlet itself—portlet content is retrieved from the web page from which the clipping originated.

    • Parameterize Inputs—Options for customizing parameters associated with the clipped content.

      Click the Click to start parameterizing checkbox to customize parameters associated with the content, and then perform the following steps:

      1. From the Parameters list, choose the parameters you intend to customize.

      2. From the Personalizable list, select a parameter if you intend to enable users to provide their own parameter values when they personalize the portlet. Select None if you do not want to allow this.

      3. In the Display Name field, enter a name to be displayed for the parameter.

      4. In the Default Value field, enter a default value for the parameter.

      For an example of personalizing the parameters of a web clipping, see Section 28.2.3.2, "Parameterizing a Web Clipping Portlet."

      Note:

      The Parameterize Inputs section displays only if you entered information in a form and then selected the section including the form for your web clipping.
  9. Click OK to save changes to property values and to display the selected clipping in the Web Clipping portlet on your page.

    Note:

    Web Clipping portlets support additional properties that influence the way the portlet is rendered. For information, see Section 28.3, "Setting Web Clipping Portlet Properties."

    Figure 28-5 shows the selected web clipping in your Web Clipping portlet.

    Figure 28-5 Clipped Content in a Web Clipping Portlet

    Clipped content in a Web Clipping portlet
    Description of "Figure 28-5 Clipped Content in a Web Clipping Portlet"

Note:

The Refresh link in the Web Clipping portlet retrieves data from cache or from the originating web site, depending upon the value you provided for Expires (minutes).

28.2.3 Adding a Web Clipping That Users Can Personalize

This section walks you through a demonstration of how you can enable end users to personalize their own view of the content in a Web Clipping portlet. It includes the following subsections:

28.2.3.1 Selecting a Clipping from OTN

In this task, you navigate to the Oracle Technology Network (OTN) and search for specific information to clip.

To select a clipping from OTN:

  1. In the portlet header, click the Customize icon.

    The Find a Web clipping page opens.

  2. In the URL Location field, enter the following URL, and click Start:

    http://www.oracle.com/technology/products/ias/portal/index.html
    

    OTN displays the Portal page.

  3. Enter a search string in the Search field at the top of the page. For this example, enter web clipping portlet, then click the Search icon.

    Results display in Web Clipping Studio (Figure 28-6).

    Figure 28-6 OTN Search Results in Web Clipping Studio

    OTN search results in Web Clipping Studio
    Description of "Figure 28-6 OTN Search Results in Web Clipping Studio"

  4. Click Section on the Web Clipping Studio banner.

    Web Clipping Studio divides the target web page into clippable sections (Figure 28-7).

    Figure 28-7 The Choose Links on an OTN Search Results Page in Web Clipping Studio

    Choose link on an OTN page in Web Clipping Studio
    Description of "Figure 28-7 The Choose Links on an OTN Search Results Page in Web Clipping Studio"

  5. At the top-left corner of the area that contains the search results (just above the text Revise search), click Choose.

    A preview of the search result section opens.

  6. Click Select to confirm that the search result section is the one you want to clip.

  7. On the Find a Web clipping page, click OK to display the clipped content in the Web Clipping portlet (Figure 28-8).

    Figure 28-8 Clipped Content Displayed in Web Clipping Portlet

    Clipped content displayed in Web Clipping portlet
    Description of "Figure 28-8 Clipped Content Displayed in Web Clipping Portlet"

28.2.3.2 Parameterizing a Web Clipping Portlet

In this task, you edit the properties of the Web Clipping portlet to enable users to display different search results in the portlet.

To parameterize a Web Clipping portlet:

  1. Once you have clipped the OTN search results as described in Section 28.2.3.1, "Selecting a Clipping from OTN," click the Customize icon in the Web Clipping portlet header.

  2. In the Find a Web clipping page, modify the following items in the Properties section:

    • From the URL Rewriting dropdown list, choose Inline to specify that link targets open inside the portlet, rather than in a new browser window.

    • In the Title field, enter OTN Search. This title appears in the header of your Web Clipping portlet and on the pages where users can personalize parameters for the web clipping.

    Figure 28-9 shows the Properties and Parameterize Inputs sections of the Find a Web clipping page.

    Figure 28-9 Web Clipping Properties

    Portlet properties on the Find a Web clipping page
    Description of "Figure 28-9 Web Clipping Properties"

  3. Because the content displayed in the portlet was reached by entering information in the Search field on OTN, you can customize the parameters used by the search to enable users to specify their own search string.

  4. Under the Parameterize Inputs section, select Click to start parameterizing, and make the following changes in the parameters table:

    • In the Parameters column, select keyword from the dropdown list.

    • In the Personalizable column, select Param1 from the dropdown list.

    • In the Display Name column, enter OTN Search.

    • Make sure that Default Value displays web clipping portlet to be sure you have selected the right parameter.

  5. Click OK to display the default search results in the Web Clipping portlet.

28.2.3.3 Personalizing a Web Clipping Portlet

In this task, you personalize a Web Clipping portlet to display different search results in the portlet.

To personalize a Web Clipping portlet to display different search results:

  1. In the Web Clipping portlet header, click the Personalize icon.

    Note:

    When running a portlet that has an Edit mode, the Personalize option in the portlet header appears only to authenticated users. Unauthenticated or public users do not see the Personalize option. What this means is that, for personalization to work, some form of security must be implemented for your application.

    If you are a developer creating portlets and pages, then you may want a quick way to test the Edit mode of your portlet without creating a complete security model for your application. For information about how you can quickly add the necessary security for testing portlet personalization, see the “Configuring Basic Authentication for Testing Portlet Personalization” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

  2. In the resulting Find a Web clipping page, scroll down to the Inputs section.

    Notice that the parameter field for the search string is labeled OTN Search, as you specified for the Display Name while parameterizing the Web Clipping portlet. (Figure 28-10).

    Figure 28-10 A Web Clipping in the Personalize Mode

    Parameter input fields on the Find a Web clipping page
    Description of "Figure 28-10 A Web Clipping in the Personalize Mode"

  3. In the OTN Search field, enter a different search string.

    For example, enter WebCenter.

  4. Click OK.

    The Web Clipping portlet now displays the search results for WebCenter from OTN.

28.3 Setting Web Clipping Portlet Properties

The Web Clipping portlet has associated properties that control the look and feel of the portlet on the page. Users with sufficient privileges can access these properties through the Component Properties dialog (Figure 28-11).

Figure 28-11 Web Clipping Portlet Component Properties

Component Properties dialog

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Events service task flows and describe the properties on the Parameters tab:

28.3.1 What you Should Know About Web Clipping Portlet Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 28.3.2, "Web Clipping Portlet Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

28.3.2 Web Clipping Portlet Parameters

Table 28-1 describes the parameters that are unique to the Web Clipping portlet.

Table 28-1 Web Clipping Portlet Component Parameters

Property Description Location

Param#

Use to map page parameters to the parameters specified when the Web Clipping portlet was defined. These parameters enable you to contextually wire portlets and pages. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Parameters tab

All Modes Shared Screen

For Web Clipping, set this property to false to ensure that all portlet modes, except Show, are rendered each on their own page. Setting this property to true may prevent you from editing certain sections of your web clipping in the Web Clipping wizard.

Display Options tab

Id

A unique identifier for the portlet instance.

Display Options tab

Partial Triggers

Use to initialize a partial page refresh, which is a way of refreshing an area of a page without having to redraw the entire page.

Display Options tab

Render Portlet in I Frame

Use to render the portlet in an inline frame (IFRAME), omit an IFRAME, or let the portlet decide. Valid values are:

  • auto (default): The portlet tag checks the portlet response and decides if an IFRAME is required

  • true: Render the portlet instance in an IFRAME

  • false: Render the portlet instance inline

Placing a portlet inline on a page provides a better user experience as compared to placing it in an IFRAME. However, at times, it may be required to include a portlet in an IFRAME. For example:

  • The portlet is a JSF portlet

  • The portlet contains a file upload element

  • The parser throws an exception because it is not able to parse the markup

Display Options tab

Title

Enter a title for the Web Clipping portlet, to display in the portlet header.

Display Options tab


28.4 Current Limitations of Web Clipping

When you use Web Clipping, you should be aware of the following limitations:

28.5 Troubleshooting Web Clipping

This section provides information to help you troubleshoot problems you may encounter while using Web Clipping.

Encountered "x" at line n, column n. Was expecting one of : "x", "y" ...

Parser error message written to the log file.

Problem

The web content displayed in the Web Clipping portlet contains invalid HTML or JavaScript.

Solution

This is a site-specific issue, not a Web Clipping error. Contact the site's administrator for assistance.