Upgrading WSRP Producer 1.0 Installations
To upgrade an existing WSRP Producer 1.0 installation,
you must update the portlets.xml file to use the latest wsrp-producer.xml
file format.
In the 1.0 version of the WSRP Producer, portlet metadata
was entered in the
portlets.xml file located in the \bin subdirectory
of the WSRP Producer web application. In the 1.1 MP1 and above versions
of the WSRP Producer, this file has been renamed
wsrp-producer.xml and contains additional configuration settings that control the
functionality of the WSRP Producer.
The 1.0 portlets.xml format
is not forward compatible with later versions of the WSRP Producer
and must be upgraded to the wsrp-producer.xml format. The required
changes are summarized below.
- Change the portlets.xml file name to “wsrp-producer.xml”.
- Wrap the 1.0 root element <portlets> in the new root element <wsrp-producer>.
- Change the default namespace to http://www.bea.com/al/dotnet/wsrpproducer/1.1.
- Add a namespace declaration to the root element for the
xml schema namespace using the “xs” prefix as follows: xmlns:xs="http://www.w3.org/2001/XMLSchema"
- Within each <portlet> element, make
the following changes:
- Remove all <portlet-name> elements.
This element is no longer used.
- If you have multiple <display-name> elements for a single portlet, remove all but one. Only a single <display-name> element is allowed for each portlet.
If you included display name localization information in portlets.xml,
it must be changed to the new format. For detailed instructions, see Localizing Portlet Metadata in the Oracle WebCenter Portlet
Toolkit for .NET Development Guide.
- Rename the <view-url> element
to <url> and add the id attribute
with the value “default”..
- In the <supports> element, make
the following changes in each <portlet-mode> element:
- Add the child element <name> and set the
text content as follows:
- If portlet-mode was “View” use “wsrp:view” as the value of the <name> element.
- If portlet-mode was “Edit” use “wsrp:edit” as the value of the <name> element.
- If portlet-mode was “Preview” use “wsrp:preview” as the value
of the <name> element.
- Add the child element <url> with a single idref attribute with the value “default”.
For example, this entry in portlets.xml: <portlet-mode>View</portlet-mode>
becomes this entry in wsrp-producer.xml:
<portlet-mode>
<name>wsrp:view</name>
<url idref="default"/>
</portlet-mode>
- In the <portlet-info> element,
add a lang attribute with the appropriate locale
(usually “en”) to the <title> and <short-title> elements.
- Rename the <portlet-preferences> element to <portlet-properties>. Rename each <preference> child element to <property> and add a type attribute with the value “xs:string”.
For more information on wsrp-producer.xml, see WSRP Producer
Configuration Elements (wsrp-producer.xml) in the Oracle WebCenter Portlet
Toolkit for .NET Development Guide. For a detailed schema reference,
see the wsrp-producer.xsd file in the WSRP Producer bin directory.