Oracle9iAS Portal Developer Kit
Installing the PDK-URL NLS Portlets (V2)

Welcome to PDK-URL Services.  Now that you have successfully installed the PDK-Java Framework and samples, you may want to create URL-based portlets.  PDK-URL Services has extended the PDK-Java to support portlets created in any Web-based language.  This article describes how to install and configure the PDK-URL Services NLS sample.  There are three portlets in the PDK-URL Services NLS sample:

The PDK-URL services NLS sample provider is pre-configured within jpdk.ear, with a service ID of urn:urlnls.

REQUIREMENTS

  1. Oracle9iAS Portal 3.0.8.9.8 or later.  Most features of the PDK-URL Services work with older versions, but is only certified against this version of Oracle9iAS Portal. Certain features such as authenticated portlets will not work on older versions of Oracle9iAS Portal.
  2. PDK-Java 9.0.2.

ASSUMPTIONS

  1. You have already successfully installed the PDK-Java Framework and samples by following the Installing the PDK-Java Framework and Samples (V2) article. These samples use the PDK-Java Framework.
  2. You have installed Portal on a database that is using a character set compatible with the language of your portlet.  For example, if your portlet has multibyte characters then the Portal database must be using a character set compatible with this (i.e., UTF-8).

CONFIGURING AND TESTING THE SAMPLE PROVIDER

The PDK-URL Services NLS sample provider has been pre-configured within the jpdk.ear.  However, you may need to change the provider.xml file to specify the proxy server you use.  Open the provider.xml file for the sample (it should be located in the WEB-INF/providers/urlnls directory) and provide appropriate replacement values for the following tags:

<proxyInfo class="oracle.portal.provider.v2.ProxyInformation">
     <httpProxyHost>www-proxy.us.oracle.com</httpProxyHost>
     <httpProxyPort>80</httpProxyPort>
</proxyInfo>

Next, you can test that the NLS sample is properly configured with OC4J.

  1. Execute the NLS sample provider servlet from OC4J.

         For example:  http://myserver.mydomain.com:port/jpdk/providers/urlnls

  2. Review the content of the test page displayed.

    If you did not receive the test page, verify that you can execute standard servlets using Oracle9iAS.

REGISTERING YOUR PROVIDER

You must now register the NLS portlet provider with Oracle9iAS Portal.

  1. On the Build tab of the Portal Design-Time Pages root page, click on Register a Portlet Provider within the portlet called Provider.
  2. Enter Provider information for the Sample.
    1. Name: URL_NLS_sample
    2. Display Name: PDK-URL Services NLS sample
    3. Timeout: 300
    4. Timeout Message: PDK-URL Services NLS sample Timed Out
    5. Implementation Style: Web
    6. URL: http://myhost.com:8888/jpdk/providers (if you're using Oracle9iAS Portal 3.0.9, append the service id, urlnls, to the URL)
    7. Service Id: urn:urlnls
    8. Login Frequency: Never
  3. Click Finish.

ADDING YOUR PORTLET TO A PAGE

Add the PDK-URL Services NLS portlets to a page. The portlets will be listed under the Provider called "PDK-URL Services NLS sample".  
  1. To view the portlet in the appropriate language, select the following in IE 5.0 or above.
    1. View -> Encoding -> Japanese(EUC) for the Japanese portlet.

     

  2. If browser is not I.E (5.0 or higher), then you must download the appropriate fonts to render multi-byte character sets.
    1. A simple way of downloading a font is to use IE for viewing the URL. If the font is not present, it is downloaded automatically. Then,
      1. Set the browser encoding to the respective local language encoding. 

        1. In I.E. encoding can be set using View -> Encoding -> <Encoding-Type>

        2. Go into Preferences and set the font based on what was downloaded using IE.  Then, view by by selecting View -> Character Set -> <Character-set-Type>

You have now successfully installed and setup the PDK-URL Services NLS sample portlets.


Revision History:

·         March 2002.