Skip Headers
Oracle® Fusion Middleware Developer's Guide for Oracle WebCenter
11g Release 1 (11.1.1)
E10148-02
  Go To Documentation Library
Library		 Go To Product List
Product		 Go To Table Of Contents
Contents		 Go To Index
Index
Previous
Previous 		 Next
Next		  

32 Creating Content-Based Portlets with Web Clipping

Web Clipping is a publishing portlet that enables you to integrate any web application with your WebCenter application. Web Clipping is designed to give you quick integration by leveraging the existing user interface of a web application. 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 includes the information you are required to know to use Web Clipping in your Oracle JDeveloper environment. For information on how to use Web Clipping at runtime, refer to the Oracle Fusion Middleware User's Guide for Oracle WebCenter.

This chapter includes the following sections:

For information about additional Web Clipping portlet producer configuration like repository and proxy settings and producer security, see Appendix E, "Additional Portlet Configuration."


Note:

You can find more information about developing different types of portlets and information about producers and other portlet technologies in Chapter 27, "Overview of Portlets."

32.1 Introduction to Web Clipping

Web Clipping enables the 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 WebCenter application as a portlet.

Web Clipping portlets support the following features:

Web Clipping definitions are stored persistently in a repository. By default, in Oracle JDeveloper, the Web Clipping producer is configured to use Oracle Metadata Services (MDS), which is file-based, as a repository. You can alternatively select to use a database schema for your Web Clipping repository. For information about configuring a Web Clipping repository, see Section E.3.1, "Web Clipping Repository Configuration."

Any secure information, such as passwords, is stored in an encrypted form, according to the Data Encryption Standard (DES), by using Oracle encryption technology.

32.2 Adding Web Clipping to Your Application

As described in Chapter 9, "Consuming Portlets", you can add a Web Clipping portlet to a JSP document created through Oracle JDeveloper. The Web Clipping portlet producer is included in the Integrated WebLogic Server (WLS), the default server installed with Oracle JDeveloper.


Note:

The Web Clipping portlet producer is also included within the WLS_Portlets managed server in the default domain in a full Oracle Fusion Middleware installation. Therefore, for your application, you can choose to register this producer from the WLS_Portlets managed server and the default producer in Integrated WLS.

In Oracle JDeveloper, after you start Integrated WLS, you can register the Web Clipping producer by using the Register Oracle PDK-Java Portlet Producer wizard. When this producer is registered, portlets become available either in the Application Resources panel or the Resource Palette. From here, you can drag portlets onto your *.jspx page.

For more information about:

After you register the Web Clipping portlet producer, you can simply drag the Web Clipping portlet onto your page. If you are using a PanelCustomizable or ShowDetailFrame component, then drag the portlet on top of that component instead of af:form. In the Structure pane, the Web Clipping portlet must display under the PanelCustomizable or ShowDetailFrame component. In the Page Editor, the portlet must display inside the PanelCustomizable or ShowDetailFrame component.


Note:

When you add an instance of Web Clipping onto your page in Oracle JDeveloper, open the Property Inspector for the portlet and ensure that the AllModesSharedScreen and RenderPortletInIFrame properties are set as follows:

  • AllModesSharedScreen is set to False to display the Customize and Personalize in full page size. If you do not set this property to False, then when you personalize the Web Clipping portlet at runtime, the text displayed on the page may be distorted.

  • RenderPortletInIFrame is set to True to display the Web Clipping in its own iFrame in the View mode.

When you run your application page, the Web Clipping portlet displays in your default browser. For information about how to work with a Web Clipping portlet at runtime, see the "Working with the Web Clipping Portlet" chapter in the Oracle Fusion Middleware User's Guide for Oracle WebCenter.


Note:

To clip SSL-enabled web sites, you must add certificates of those sites to the certificate store. You are not required to add certificates of SSL-enabled web sites that use Equifax, VeriSign, or Cybertrust certificates because these certificates are included in the default certificate store.

For information about adding certificates, see Section E.3.3.1, "Adding Certificates for Trusted Sites."

32.3 Integrating Authenticated Web Content Using Single Sign-On

You can leverage Oracle Single Sign-On to integrate content from external web sites that require authentication, into a Web Clipping portlet. This section walks you through an example that demonstrates how you can do this.

The example integrates a secured page from an external application named My Oracle Support into a Web Clipping portlet.

To integrate an external application:

  1. Open your WebCenter application in Oracle JDeveloper.

  2. Register the external application, specifying the authentication information by performing the following steps.

    1. In the Applications Navigator, right-click your project and choose New.

    2. In the New Gallery, expand the General category, select External Application, then select External Application on the right, and click OK.

    3. On the Name page of the Register External Application wizard, enter a name and display name for the external application, for example, MyOracleSupport.

    4. On the General page, enter the following details:

      • In Login URL, enter the URL of the application, for example, http://metalink.oracle.com/metalink/plsql/sit_main.showSitemap?p_showTitle=0. To determine the URL, navigate to the desired application in a browser and note the URL.

        For Form-based Authorization, view the source of the login page for the external application and note the URL to be accessed during the login action.

      • In User Name/ID Field Name, enter the field name that the external application uses for the user name. Determine the field name by viewing the source for the desired page. If the Authentication method uses Basic Authentication, then you are not required to enter a field name. For MyOracleSupport, you can leave this field blank.

      • In Password Field Name, enter the field name that the external application uses for the password. Determine the field name by viewing the source for the desired page. If the authentication method uses Basic Authentication, then you are not required to enter a field name. For MyOracleSupport, you can leave this field blank.

      • Select BASIC as the authentication method.

        Figure 32-1 shows the General page of the Register External Application wizard.

        Figure 32-1 Registering an External Application

        Description of Figure 32-1 follows
        Description of "Figure 32-1 Registering an External Application"

    5. On the Additional Fields page, you can specify names and values of any additional fields that are submitted with the login form of the external application. To specify a field name that is used to indicate a redirection URL, enter redirectFieldName in Field Name and specify the required value in Default Field Value. For this example, you are not required to enter additional fields.

      Figure 32-2 shows the Additional Fields page of the Register External Application wizard.

      Figure 32-2 Specifying Additional Fields

      Description of Figure 32-2 follows
      Description of "Figure 32-2 Specifying Additional Fields"

    6. On the Shared Credentials page, specify whether you want to use shared credentials that enable authenticated users to access the external application. To enable the shared credentials feature, select the Specify Shared Credentials checkbox. Then enter the user name and password and click Next.

      Figure 32-3 shows the Shared Credentials page of the Register External Application wizard.

      Figure 32-3 Specifying Shared Credentials

      Description of Figure 32-3 follows
      Description of "Figure 32-3 Specifying Shared Credentials"

    7. On the Public Credentials page, specify whether unauthenticated users (public users) can access the external application. To enable the public credentials feature, select the Specify Public Credentials checkbox. Then enter the user name and password.

      Figure 32-4 shows the Public Credentials page of the Register External Application wizard.

      Figure 32-4 Specifying Public Credentials

      Description of Figure 32-4 follows
      Description of "Figure 32-4 Specifying Public Credentials"

    8. Click Finish.

  3. For the Web Clipping portlet, register the Web Clipping producer by performing the following steps:

    1. In the Applications Navigator, right-click your project and choose New.

    2. In the New Gallery, expand the Web Tier category, select Portlets, then select Oracle PDK-Java Producer Registration from the list on the right, and click OK.

    3. On the Specify Producer Name page of the Register Oracle PDK-Java Portlet Producer wizard, enter the producer name, for example webClippingMyOracleSupport.

    4. Click Next.

    5. On the Specify Connection Details page, specify the following details:

      • In the URL Endpoint field, specify the URL for the Web Clipping producer in the following format:

        http://host:port/portalTools/webClipping/providers/webClipping

        Note that host:port refers to the host and port where the Web Clipping producer is located.

      • If you use a proxy server to contact web producers from your application, then select the Use Proxy for Contacting Producer checkbox and enter the proxy details.

      • Select the Associate Producer with External Application checkbox, and from the list of values, select MyOracleSupport that you registered earlier. The Enable Producer Sessions checkbox also gets selected in this step.

        Figure 32-5 shows the Specify Connection Details page of the Register Oracle PDK-Java Portlet Producer wizard.

        Figure 32-5 Associating a Web Clipping Producer with an External Application

        Description of Figure 32-5 follows
        Description of "Figure 32-5 Associating a Web Clipping Producer with an External Application"

    6. Click Next.

    7. On the Specify Additional Registration Details page, specify the execution timeout, subscriber ID, and shared key values, if required.

    8. Click Finish.

  4. Add a portlet to a *.jspx page, using the webClippingMyOracleSupport producer that you just registered.

  5. Run the *.jspx page.

  6. If you did not specify shared or public credentials for the external application representing MyOracleSupport, then the portlet contains an Update login information link. Click this link and enter your credentials. Then, click OK to log on to MyOracleSupport. (Figure 32-6)

    Figure 32-6 Logging into the Integrated External Application

    Description of Figure 32-6 follows
    Description of "Figure 32-6 Logging into the Integrated External Application"

  7. Select a section of a page that you intend to display in the Web Clipping portlet by performing the following steps:

    1. Click the Actions icon on the header of the Web Clipping portlet, and select Customize.

      The Find a Web Clipping page displays.

    2. In the URL Location field, the default URL for the external application is displayed. (Figure 32-7)

      Figure 32-7 Finding a Web Clipping

      Description of Figure 32-7 follows
      Description of "Figure 32-7 Finding a Web Clipping"

    3. Click Start. The Web Clipping Studio displays the page from the integrated external application.

    4. Browse to the web page that contains the content you want to clip. After you navigate to the required web page, click Section in the Web Clipping Studio banner.

      Web Clipping Studio divides the web page into clippable sections.

    5. At the top-left corner of the section you want to clip, click Choose.

    6. Web Clipping Studio displays a preview of your selected section. If it is the section you want to clip, then click Select on the Web Clipping Studio banner.

      The Web Clipping Studio displays the Find a Web clipping page, showing the properties of the clipping.

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

    8. Click OK to display the selected web clipping in the Web Clipping portlet on your page.

Now, the web clipping, even though it is from a page requiring authentication, is available in your portlet.

Note that you can associate only one external application with a producer. For each external application, you must register a new producer. Each WebCenter application user accesses the authenticated content using their user name and password for that system, not the page designer's credentials.

32.4 Advanced Features of Web Clipping

Web Clipping supports certain advanced features. You can configure custom authentication methods by using the Web Clipping Transport API and rewrite image links to use a resource proxy.

32.4.1 Using Web Clipping Open Transport API

To support custom authentication methods, users can use the Web Clipping Transport API. To extend the Web Clipping transport layer to support custom authentication methods, users must perform the following implementation and deployment procedures:

Implementation

Users can implement their own transport classes.

  • Users can override two use cases of the oracle.portal.wcs.transport.http.HttpTransportLiaison interface. In Web Clipping, this interface is used to abstract the HTTP transport layer. By default, the two use cases of this interface are manifested by following implementations:

    • HttpClientStudioTransportLiaison, which handles HTTP transport in Web Clipping Studio mode

    • HttpClientProviderTransportLiaison, which handles HTTP transport in Web Clipping Producer show mode

    To support more authentication methods, users must override the addRequestHeaders methods for both the Studio and Provider HttpClientTransportLiaison implementations to add their own authentication-specific headers. For information, see Oracle WebLogic Server Web Clipping API Reference.

  • Users must compile the new subclasses and package them into a JAR file. For example, to compile the new subclasses, users can use the following command:

    javac -classpath path_to_wcejar -d classes/

    Where, path_to_wcejar refers to the path to the wce.jar file.

    To create the JAR file, for example, users can run the following command from the classes directory:

    jar cvf ../mytransport.jar

    Where, mytransport.jar refers to the JAR file users want to create.

Deployment

Users must deploy the JAR file to support the custom authentication method.

To deploy the JAR file, users must perform the following tasks:

  1. Place the JAR file into the class path or shared library that is used by the Web Clipping producer at runtime.

  2. Register the transport class in the web.xml file for Web Clipping producer by making the following modifications to the context parameters defined for HttpClientProviderTransportLiaison and HttpClientStudioTransportLiaison:

    • Change the parameter value for oracle.webclipping.provider.TransportLiaisonClass to the name of the new class extended from the HttpClientProviderTransportLiaison class.

    • Change the parameter value for oracle.webclipping.studio.TransportLiaisonClass to the name of the new class extended from the HttpClientStudioTransportLiaison class.

  3. Restart the producer server for the changes to take effect.

32.4.2 Rewriting Image Links to Use a Resource Proxy

Web Clipping enables users to rewrite image links to use a resource proxy. To enable this feature, you must add the following entry in the web.xml file of the Web Clipping producer:

<env-entry>
    <env-entry-name>oracle/webclipping/rewriteImageLink</env-entry-name>
    <env-entry-type>java.lang.Boolean</env-entry-type>
    <env-entry-value>false</env-entry-value>
</env-entry>

32.5 Current Limitations of Web Clipping

This section lists current limitations of Web Clipping.

  Previous
Previous 		 Next
Next
  Go To Documentation Library
Library		 Go To Product List
Product		 Go To Table Of Contents
Contents		 Go To Index
Index