Oracle9iAS Portal Developer Kit
Upgrading to PDK-URL Services v9.0.2

This document describes how to upgrade your PDK-URL Services v3.0.9 provider to PDK-URL Services v9.0.2. The jump in version numbers reflects the synchronization of version numbers with Oracle9iAS v9.0.2, of which the PDK-URL Services is a component.

UPGRADING THE PROVIDER.XML

To upgrade your PDK-URL Services provider to PDK-URL Services v.9.0.2, you simply need to modify the provider.xml file of your provider. Then your provider will be ready for deployment on OC4J (see the article Installing the PDK-URL Services Samples (V2)). This article simply describes what you need to do to upgrade your provider.xml file.

There are two ways to upgrade your provider.xml file: automatically and manually. You can automatically upgrade the file by placing it in the same directory as the upgrade.bat file provided by PDK-URL Services and then running upgrade.bat. This will automatically convert the provider.xml file to a v2 compliant provider.xml.

To manually upgrade your provider.xml file, you must change the syntax of any tag attributes that refer to a java package that is specific to v1. Use the following table as a guide. Once you have converted all of the tag attributes to reflect the appropriate v2 java package names, you have completed all that is necessary to upgrade your provider.

> Tag Name | Syntax in v1 | Syntax in v2
> provider | <provider class="oracle.portal.provider.v1.http.URLProvider" session="true"> | Divided into two parts URLProviderDefinition - for containing meta data information. URLProviderInstance - for managing the portlets owned by this provider instance. <provider class="oracle.portal.provider.v2.http.URLProviderDefinition"> <providerInstanceClass> oracle.portal.provider.v2.http.URLProviderInstance </providerInstanceClass>
> authentication | <authentication class="oracle.portal.provider.v1.http.Authentication"> | <authentication class="oracle.portal.provider.v2.security.Authentication">
> proxyInfo | <proxyInfo class="oracle.portal.provider.v1.http.ProxyInformation"> | <proxyInfo class="oracle.portal.provider.v2.ProxyInformation">
> httpsProxyInfo | <httpsProxyInfo class="oracle.portal.provider.v1.http.ProxyInformation"> | <httpsProxyInfo class="oracle.portal.provider.v2.ProxyInformation">
> portlet | <portlet class="oracle.portal.provider.v1.http.URLPortlet"> | <portlet class="oracle.portal.provider.v2.http.URLPortletDefinition">
> render | <renderer class="oracle.portal.provider.v1..RenderManager"> | <renderer class="oracle.portal.provider.v2.render.RenderManager">
> showPage | <showPage class="oracle.portal.provider.v1.http.URLRenderer"> | <showPage class="oracle.portal.provider.v2.render.http.URLRenderer">
> filter | <filter class="oracle.portal.provider.v1.http.HtmlFilter"> | <filter class="oracle.portal.provider.v2.render.HtmlFilter">
> securityManager | <securityManager class="oracle.portal.provider.v1.http.URLSecurityManager"> | <securityManager class="oracle.portal.provider.v2.security.URLSecurityManager">

Revision History:

- January 2002