5 Creating Content-Based Portlets with Web Clipping

5.2.1 Adding a Web Clipping Portlet to a Page

To add a Web Clipping portlet to an OracleAS Portal page:

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.

   Figure 5-1 shows the Page Groups portlet.

   Figure 5-1 Viewing the Page Group

   
   Description of "Figure 5-1 Viewing the Page Group"
   
   

3. Figure 5-2 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-2 Selecting a Page

   
   Description of "Figure 5-2 Selecting a Page"
   
   

4. The page is displayed. In the region in which you want to add the Web Clipping portlet, click the Add Portlet icon.

   Figure 5-3 shows a portion of the page.

   Figure 5-3 Adding a Portlet to a Page

   
   Description of "Figure 5-3 Adding a Portlet to a Page"
   
   

5. In the Add Portlets page, navigate to the Web Clipping Portlet link and click it. The Web Clipping Portlet moves to the Selected Portlets box.

   By default, the Web Clipping portlet is located in the Portal Builder page of the Portlet Repository. If you cannot find this page, use the Search field to find the portlet.

6. Click OK to add a Web Clipping portlet to your page.

   Figure 5-4 shows the Web Clipping portlet added to your page.

   Figure 5-4 Web Clipping Portlet Added to a Page

   
   Description of "Figure 5-4 Web Clipping Portlet Added to a Page"
   
   

5.2.2 Selecting a Section of a Web Page to Display in the Web Clipping Portlet

To select a section of a Web page to display in the Web Clipping portlet, you use the Web Clipping Studio. Using the Web Clipping Studio, you can:

• Browse for Web content

• Section the chosen target page

• 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 select a section of a Web page to display in the Web Clipping portlet:

1. Above the Web Clipping portlet, click the Edit Defaults icon, as shown in Figure 5-5.

   Figure 5-5 Editing Default Settings

   
   Description of "Figure 5-5 Editing Default Settings"
   
   

   The Find a Web Clipping page is displayed.

2. In the URL Location field, enter the location of the starting Web page that links to the content you want to clip, as shown in Figure 5-6.

   Figure 5-6 Specifying a URL

   
   Description of "Figure 5-6 Specifying a URL"
   
   

3. Click Start.

   The Web Clipping Studio displays the page you specified, as shown in Figure 5-7.

   Figure 5-7 Browsing to a Page Containing Content for a Web Clipping

   
   Description of "Figure 5-7 Browsing to a Page Containing Content for a Web Clipping"
   
   

   Note that the URL in the browser bar changes from:

   http://host:port/portal/page?_dad=portal&_schema=PORTAL...
   
   

   To:

   http://host:port/portalTools/webClipping...
   
   

4. Browse to the page that contains the content you want to clip.

   As you click hyperlinks in the Web page, your navigation links are recorded.

   
   

   Note: Any browsing operations that do not contribute to the eventual Web clipping will be discarded. Only the significant browsing operations are recorded for later playback during the show mode; any 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. Once you display the page that contains the content you want to clip, in the Web Clipping Studio banner, click Section, as shown in Figure 5-8.

   Figure 5-8 Sectioning the Target Web Page

   
   Description of "Figure 5-8 Sectioning the Target Web Page"
   
   

   Sectioning divides the target Web page into its clippable sections, as shown in Figure 5-9. After you click Section, you are no longer able to browse links in the displayed page. If you want to continue navigation, click Unsection in the Web Clipping Studio banner.

   Figure 5-9 Sectioned Target Web Page

   
   Description of "Figure 5-9 Sectioned Target Web Page"
   
   

6. At the top left of the section of the Web content you want to clip, click Choose.

   You can choose only one section as a clipping at a time.

   
   

   Note: To increase the number of sections available from which to choose, click Section Smaller in the Web Clipping Studio banner. For example, you would click Section Smaller to drill down one level of nested tables. To decrease the number of sections available from which to choose, click Section Larger.

   
   

7. Web Clipping Studio displays a preview of your chosen section. If it is the section you want, click Select in the Web Clipping Studio banner. The Web Clipping Studio displays the Find a Web Clipping page, with the properties of the clipping.

   If you do not want to use the section you clipped in your portlet, click Unselect to return to the page containing the section. You can choose another section on the page, or click Unsection to navigate to another page.

   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, Web Clipping displays a preview, but the preview correctly shows only whitespace. In this case, click Unselect in the preview page to return to the sectioned page. Then, select a section containing data.

8. In the Find a Web Clipping page, click OK to display the selected Web clipping in the Web Clipping portlet on your page. (You can edit default properties in the page. See Section 5.2.3, "Setting Web Clipping Portlet Properties" for more information.)

   Figure 5-10 shows the content added to the Web Clipping portlet.

   Figure 5-10 Clipped Content Added to the Web Clipping Portlet on a Portal Page

   
   Description of "Figure 5-10 Clipped Content Added to the Web Clipping Portlet on a Portal Page"
   
   

Note that the Refresh link in the Web Clipping Portlet retrieves fresh data from the originating Web site. The Portlet Refresh link reloads the portlet, but it may retrieve the data from the cache, depending upon the settings for expiration.

5.2.3 Setting Web Clipping Portlet Properties

You can edit various portlet settings to change the appearance of the Web Clipping portlet and to specify how end users can interact with the portlet.

To set Web Clipping portlet properties:

1. At the top left of the Web Clipping portlet, click the Edit Defaults icon. Web Clipping Studio displays the Find a Web Clipping page with a Properties section, as shown in Figure 5-11.

   Figure 5-11 Properties Section of Find a Web Clipping Page

   
   Description of "Figure 5-11 Properties Section of Find a Web Clipping Page "
   
   

2. From the URL Rewriting list in the Properties section, choose Inline if you want link targets to be displayed inside the portlet, or choose None if you want link targets to replace the current Portal page in the browser.

3. In the Title field, enter a title to display in the portlet banner.

4. In the Description field, enter a description of the portlet.

5. In the Time Out (seconds) field, enter the amount of time (in seconds) for the Web Clipping provider to attempt to contact the Web page from which the content was clipped.

6. In the Expires (minutes) field, enter the amount of time (in minutes) that cached content is valid. Any requests for portlet content that occur within the time period you specify will be satisfied from the cache.

   Once the cache period is exceeded, requests for portlet content will be satisfied by retrieving content from the portlet's Web Clipping data source. The cache will also be refreshed with this content.

7. If you entered any information in a form while clipping content for the Web Clipping portlet, the Parameterize Inputs section is available. Select the Click to start parameterizing check box to customize parameters associated with the Web Clipping portlet content. Then:

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

   2. From the Personalizable list, select a parameter if you want to allow end users to provide their own values for the parameters 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 value to use by default for the parameter.

   Section 5.4.3, "Personalizing a Web Clipping Portlet" provides an example of personalizing parameters.

8. Click OK.

5.4.1 Adding a Web Clipping Portlet to a Personal Page

Administrators can set up personal pages for all users. This task assumes that the administrator has enabled this functionality. In this task, you add the Web Clipping portlet to your personal page.

1. In the Work In field of the Page Groups portlet, select the page group that contains personal pages.

   By default the Page Groups portlet is located on the Build tab of the Portal Builder page.

2. In the Pages section, select Personal Pages. Expand the node for the first letter of your user name. Figure 5-18 shows the Personal Pages.

   Figure 5-18 Expanding Page Group Map Nodes

   
   Description of "Figure 5-18 Expanding Page Group Map Nodes"
   
   

3. Click your user name. Your personal page is displayed.

4. In any portlet region, click the Add Portlets icon.

5. In the Add Portlets page, click the Web Clipping Portlet link.

   By default, the Web Clipping portlet is located in the Portal Builder page of the Portlet Repository. If you cannot find this page, use the Search field to find the portlet.

6. The Web Clipping portlet is added to the Selected Portlets list. Click OK.

5.4.2 Selecting a Clipping in OTN

In this task, you navigate to the Oracle Technology Network (OTN) and search for specific information, then select the results as the clipping for your portlet.

1. In the Web Clipping portlet, click the Edit Defaults icon.

2. In the Web Clipping Studio's Find a Web Clipping page, in the URL Location field, enter:

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

   Click Start. OTN displays the Portal Center page.

3. Enter a search string in the Search field at the top of the page. For this example, enter "web clipping portlet" (including the quotation marks), then click Search.

   The Search result is displayed in the Web Clipping Studio, as shown in Figure 5-19.

   Figure 5-19 Searching for Information on OTN

   
   Description of "Figure 5-19 Searching for Information on OTN"
   
   

4. Click Section. Web Clipping Studio divides the target Web page into its clippable sections, as shown in Figure 5-20.

5. Figure 5-20 Sectioning the Target Web Page

   
   Description of "Figure 5-20 Sectioning the Target Web Page"
   
   

6. At the top left corner of the search result, click Choose.

   A preview of the search result section displays.

   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, Web Clipping displays a preview, but the preview correctly shows only whitespace. In this case, click Unselect in the preview page to return to the sectioned page. Then, select a section containing data.

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

8. In the Find a Web Clipping page, click OK to display the selected Web Clipping in the Web Clipping portlet on your page. Figure 5-21 shows the Web Clipping displayed in the page.

Figure 5-21 Selected Web Clipping Displayed in Web Clipping Portlet

Description of "Figure 5-21 Selected Web Clipping Displayed in Web Clipping Portlet"

5.4.3 Personalizing a Web Clipping Portlet

In this task, you edit the properties of the Web Clipping portlet to allow end users to display different search results in the portlet:

1. Above the Web Clipping portlet you just added, click the Edit Defaults icon, as shown in Figure 5-22.

   Figure 5-22 Clicking Edit Defaults for the Web Clipping Portlet

   
   Description of "Figure 5-22 Clicking Edit Defaults for the Web Clipping Portlet"
   
   

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

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

   • In the Title field, enter OTN Search. This title displays in the header of your Web Clipping portlet, as well as the pages where users can personalize parameters for the Web clipping.

   Figure 5-23 shows the Properties and Parameterize Inputs sections of the Find a Web Clipping page.

   Figure 5-23 Setting Properties for a Web Clipping

   
   Description of "Figure 5-23 Setting Properties for a Web Clipping"
   
   

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 allow end users to specify their own search string.

   In the Parameterize Inputs section, select the Click to start parameterizing check box.

4. In the parameters table, make the following changes:

   • In the Parameters column, choose p_Query from the list.

   • In the Personalizable column, choose Param1 from the list. You can manually add more parameters in the provider.xml file if you need to.

   • 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.

   Figure 5-24 shows the parameters table.

5. Figure 5-24 Specifying Parameters for User Input

   
   Description of "Figure 5-24 Specifying Parameters for User Input"
   
   

6. Click OK to display the default search results in the Web Clipping portlet on your page.

7. In the Editing Views section, click View Page.

8. In the Web Clipping portlet header, click Personalize, as shown in Figure 5-25.

   Figure 5-25 Clicking Personalize in the Web Clipping Portlet Header

   
   Description of "Figure 5-25 Clicking Personalize in the Web Clipping Portlet Header"
   
   

9. In the page that displays, 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 for this parameter. In the OTN Search field, enter a different search string. For example, enter OmniPortlet 2004, as shown in Figure 5-26.

   Figure 5-26 Specifying Input for Parameters

   
   Description of "Figure 5-26 Specifying Input for Parameters"
   
   

10. Click OK.

    The Web Clipping portlet now displays the results of performing a search on OTN for OmniPortlet 2004 information, as shown in Figure 5-27.

    Figure 5-27 New Web Clipping Result Based on Customer Input Parameter

    
    Description of "Figure 5-27 New Web Clipping Result Based on Customer Input Parameter"
    
    

5.5.1 Preparing for Migration

Before you begin the migration, take the following steps:

1. Verify that the Web provider that contains the URL-based portlets you want to migrate is functional. The migration process will not succeed with non-functional URL-based portlets. To verify, make sure that the URL-based portlets are used by your Portal pages and that they appear correctly.

2. Find existing URL-based portlets.

   Before you run the migration tool, make sure that you know the file path to the service deployment properties file, which holds pointers to everything about the service, including the path to the provider.xml file that holds the URL services definitions.

   You must run the migration tool once for each service. If you have multiple services, find the entire list of service deployment properties files that will be used during migration.

   The location of these service deployment properties files may vary depending on individual deployment scenarios. Typically, with JPDK samples, they are located in:

   $INSTALL_HOME/j2ee/home/applications/jpdk/jpdk/WEB-INF/deployment
   
   

   JPDK samples that are shipped with the OracleAS Portal are located in the same directory path.

   The list of sample service deployment properties files include:

   • urlbasicauth.properties

   • urlexternalauth.properties

   • urlnls.properties

   • urlparams.properties

   • urlsample.properties

   • urlssl.properties

   In the migration process, the service deployment properties file as well as the provider.xml file used to contain old URL-based portlets will be copied and imported into the Web Clipping application, together with all the previous customizations based on the File Preference store. Because no modifications will be done on the original files used by these URL-based portlets, you do not need to back up any of these files. They can continue to be used as URL-based portlets.

3. Depending on the types of URL-based portlets you have, you may need to rearrange them:

   • Because Web Clipping does not offer parallel functionality for the XML Filter capability that URL-based portlets offer, isolate all of the URL-based portlets that use the XML Filter into a separate service deployment (and provider.xml file) that will not be migrated.

   • Because you may face limitations when migrating URL-based portlets that use external applications, you may decide that the migration is too costly for that subset of your URL-based portlets. In this case, you can isolate them into a separate service deployment (and provider.xml file) that will not be migrated.

4. Make sure that the machine where you are planning to run the migration tool has local access to the service deployment files and files that the deployment files point to, for both the URL-based portlets provider and the Web Clipping provider.

5. Make sure that both the Web Clipping Repository and the HTTP Proxy are configured, and that the proxy settings concur with those used by your deployment of URL-based portlets. If you have a proxy server that requires authentication, the Web Clipping provider must be configured with Requires Authentication enabled. Set the Login scheme to use a global log in (Use Login below for all users).

   Check the Web Clipping Provider Test page at:

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

   See the Oracle Application Server Portal Configuration Guide for more information about setting proxy authentication.

6. Shut down the OC4J instance where your Portal Tools application is running. This step ensures that no modifications are made to the files that will be migrated. Do not restart the OC4J instance until after the migration is completed.

   To shut down the OC4J instance in an Oracle Application Server instance, use the following command (from the Oracle_home/opmn/bin directory):

   opmnctl stopproc gid="OC4J_Instance"
   
   

   In this example, OC4J_Instance refers to the OC4J instance where your Portal Tools application was deployed. Typically, it is OC4J_Portal.

   To shut down a standalone OC4J instance, change to the OC4J_HOME/j2ee/home directory, then use the following command:

   java -jar admin.jar ormi://host:port/ admin admin_password -shutdown
   

5.5.2 Performing the Migration

The migration tool parses the service deployment properties file to find the provider.xml file that contains the XML definition of the URL-based portlets to be migrated.

The tool changes the Provider Definition class from URLProviderDefinition to WcProviderDefinition. For each of the URL-based portlets defined in the provider.xml file, an equivalent clipping definition is created and inserted into the Web Clipping Repository. Then, the PortletDefinition XML snippet corresponding to the portlet being migrated is replaced with a new one that uses WcPortletDefinition as its class. The replacement XML snippet contains a Clip Id that is a pointer to the newly inserted clipping definition.

The new PortletDefinition XML snippet will no longer contain the same information as it did when it was a URLPortletDefinition. Namely, the migration tool uses the URL to visit as well as the headerTrimTag and footerTrimTag to generate an equivalent Web Clipping definition that will be stored within the Web Clipping Repository and only accessible from the provider.xml file through the Clip Id. The only information remaining will be the title and description. Refer to Section 5.2.3, "Setting Web Clipping Portlet Properties" for instructions on modifying your clipping.

To migrate portlets, take the following steps:

1. Set environment variables:

   • On UNIX, set LD_LIBRARY_PATH to either the Install_home/lib or Install_home/lib32, depending on whether the operating system is 32-bit or 64-bit.

   • On Windows, set PATH to Install_home\bin

2. Change to the ORACLE_HOME/portal/jlib directory.

3. Use the following command to import the portlet to Web Clipping:

   java -Doracle.ons.oraclehome=ORACLE_HOME -jar wcwebdb.jar -import -from urlservices webclip_depprop urlsvc_depprop
   
   

   In the example, the parameters have the following meanings:

   • ORACLE_HOME refers to the directory where Oracle Application Server is installed.

   • webclip_depprop refers to the path to your webClipping service deployment properties file. The path is typically:

     Inst_Home/j2ee/OC4J_Instance/applications/portalTools/webClipping/WEB-INF/deployment/webClipping.properties
     
     

     Inst_Home refers to the location where OC4J is installed. OC4J_Instance refers to the OC4J instance where your PortalTools application is deployed. In an Oracle Application Server instance, it is usually OC4J_Portal; in a standalone OC4J instance, it may be home.

   • urlsvc_depprop refers to the path for the URL-based portlets service deployment properties file that points to URL-based portlets that you wish to migrate.

   For example, assume your URL-based portlets are deployed in the following directory on UNIX:

   $Inst_Home/j2ee/home/applications/jpdk/
   
   

   Assume that Web Clipping is deployed in the following directory and that Inst_Home is the same directory where Oracle Application Server is installed, ORACLE_HOME:

   $Inst_Home/j2ee/home/applications/portalTools/
   
   

   In this case, use the following command:

   cd $Inst_Home/portal/jlib;
   java -Doracle.ons.oraclehome=$ORACLE_HOME -jar wcwebdb.jar -import -from urlservices \
   $Inst_Home/j2ee/home/applications/portalTools/webClipping/WEB-INF/deployment/webClipping.properties \
   $Inst_Home/j2ee/home/applications/jpdk/jpdk/WEB-INF/deployment/urlsample.properties
           
   

4. Repeat Step 3 for each service you want to migrate.

5.5.3 Post-Migration Configuration

After you migrate all of the URL-based portlets, take the following steps:

1. Start the OC4J instance that hosts your provider.

   To start the OC4J instance in an Oracle Application Server instance, use the following command:

   opmnctl startproc gid="OC4J_Instance"
   
   

   In this example, OC4J_Instance refers to the OC4J instance where your Portal Tools application was deployed. Typically, it is OC4J_Portal.

   To start a standalone OC4J instance, change directory to $OC4J_HOME/j2ee/home, then use the following command:

   java -jar oc4j.jar -err errors.log
   
   

2. Update all Portal instances where URL-Based portlets were previously registered. Go to Portal Navigator to find your previously registered URL-based Portlet provider. Click Edit Registration and then click the Connection tab to edit the connection information to the newly migrated provider.

   • If you previously registered your URL-based Portlet provider using the Service Id mechanism, your provider URL looked similar to the following:

     http://host:port/jpdk/jpdk/providers
     
     

     In this case, because the Service Id field already contains urn:someservice, you now need only to update the provider URL value to the following:

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

   • If you registered your URL-based Portlet provider using a provider URL that contained the Service Id, your provider URL looked similar to the following:

     http://host:port/jpdk/jpdk/providers/service_id
     
     

     In this case, you need to update the provider to the following:

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

   For the most part, the rest of the registration details can remain as they are. However, if you plan on using the in-line rendering functionality of the migrated portlets, you must select Once Per User Session for Login Frequency.

3. Restore HTTP proxy authentication setting that you altered in preparation for the migration. During the migration process, URL-based portlets are converted to Web Clipping portlets. If the Web Clipping provider has originally been configured with Requires Authentication enabled, your migrated URL-based portlets may not function properly.

   Check the test page at:

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

   If the Login Scheme is not set to Use login below for all users, then authentication is accomplished by mapping the current portal user to a proxy server username and password. A portal user's proxy server credentials can only be entered through the Personalize link of the Web Clipping portlet. However this cannot be accomplished through the Personalize link of the migrated URL-based portlets. The workaround is to temporarily add a Web Clipping portlet to the page and personalize it to provide the security credentials. After this is complete, you can remove the temporary portlet.

4. Review each Portal page where you had used URL-based portlets and verify that the page still contains the content. Occasionally, you may find that, after migration, what used to be a "trimmed" Web page is now the entire Web page. This may be due to some of the limitations of the migration tool, which are discussed in Section 5.5.5, "Limitations in Migrating URL-Based Portlets". If this happens, edit the portlet by altering the Web Clipping associated with it.

5.5.4 Maintaining Migrated Portlets

After you have migrated the portlets, you no longer use the provider.xml file to edit the portlets. Instead, you use Web Clipping to edit the portlets, as described in Section 5.2.3, "Setting Web Clipping Portlet Properties".

Note the following:

• Whatever modifications you make to the clipping will affect it at the portlet definition level and therefore will affect all the instances of that portlet which may exist across Portal pages.

• When you modify the clipping and you have made the portlet rendering to be Inline, and have registered the provider with a Login Frequency of Once per User Session, then page viewers who have an instance of the particular portlet on their page, will need to log out of OracleAS Portal and log in again to see the changes implemented. This feature avoids disruption of the page viewer's usage of a particular portlet when it is being modified.

• For portlets with Web Clippings that require authentication to an external application prior to accessing the page containing the clip, the "off-line" editing mechanism detailed in the previous item does not provide such authentication information. Consequently, there is no way to modify the migrated clipping if the original URL-based portlet uses external applications. There is currently no workaround for this limitation.

5.5.5 Limitations in Migrating URL-Based Portlets

This sections describes limitations in migrating URL-based portlets to Web Clipping and describes some differences between the two methods.

• There is a fundamental difference between URL-based portlets and Web Clipping in the way that clippings are defined.

  URL-based portlets use the headerTrimTags and footerTrimTags tags to define the begin and end of a particular section in an HTML page. On the other hand, Web Clippings use the HTML tag path (for example, html/ body/table[2]/tr[2]/td[1]) to denote the path to use when looking for an HTML tag that would contain the clipping within the page.

  While the header and footer trim tags for URL-based portlets offer greater flexibility (that is, the clipping does not need to reside within one single HTML tag), it is not as robust. When a clipping can no longer be found in the same location within a page, there is no way to apply fuzzy matching logic to find the clipping again. On the other hand, Web Clipping stores key pieces of information to locate the clipping within the page. If the clipping is not in the same location, the fuzzy match feature looks for other candidates on the same HTML page to account for the possibility that the clip may have moved.

• The migration tool tries to find the clipping (HTML Tag) that encapsulates the headerTrimTags and footerTrimTags. Often, this will not be the exact HTML that was extracted by the URL-based portlet. In these cases, the entire Web page will be returned as the content of the migrated Web Clipping Portlet. To amend this, simply edit the portlet.

• URL-based portlets that have been migrated to Web Clipping do not support proxy authentication by default. This is because URL-based portlets inherently do not support proxy authentication and Web Clipping preserves the edit mode of the portlets. Their edit mode does not provide an opportunity to enter authentication information. To work around this restriction, add an empty Web Clipping portlet to the same portal and use the Web Clipping portlet Personalize link to enter the user name and password for proxy authentication.

• URL-based portlets that used external applications are migrated as full-page Web Clipping portlets. This means that the URL previously specified by the URL-based portlet definition will be the one used to display the full page after the log in process. Whatever headerTrimTags and footerTrimTags you have previously specified will be lost, because external application integration occurs at the Portal side while the migration tool only handles the provider side. Because you are not connected to any Portal instances at the time of the migration, and the external applications framework resides only on the Portal side, the migration tool cannot fetch the authentication information necessary to log in to parse the HTML and use the headerTrimTags and footerTrimTags that you have previously specified to compute an HTML Tag Path to store in the Web Clipping Definition.

  In maintaining migrated portlets, you can edit the clipping through links in the test page. However, this does not include URL-based portlets that used external applications to authenticate themselves to the external sites. There is currently no workaround for this issue.

• URL-based portlets that use the XML Filter cannot be migrated to Web Clipping portlets because there is a lack of such a functionality in the Web Clipping Portlet. Before proceeding with migration, make sure that you have backed up the URL-based portlets that use the XML Filter into a separate URL-based portlet provider. You must do this because the migration occurs at the provider level. That is, upon interpreting that a particular provider.xml file has URLProviderDefinition for its provider definition class, all the portlet definitions contained within that provider definition are migrated.