Converting a Portal API Web Content Viewer to the JSR 286 API | HCL Digital Experience
As installed by default, the Web Content Viewer is based on the JSR 286 API. If you have a Web Content Viewer that is based on the older HCL APIs, you can convert the viewer to the JSR 286 API. Use the convert-wcm-rendering-portlet task to convert the Portal API Web Content Viewer settings and instances to the JSR 286 Web Content Viewer portlet.
About this task
The convert-wcm-rendering-portlet task converts portlet settings of the Portal API Web Content Viewer to portlet preferences of the JSR 286 Web Content Viewer. The task also converts instances of the Portal API Web Content Viewer to instances of the Web Content Viewer. User customized portlet data that is associated with the portlet instance is converted into portlet preferences.
Procedure
- Update the file
wp_profile_root/ConfigEngine/wkplc.properties
.Confirm that the user IDs and passwords are set as required, or modify them if necessary. - Update or verify the properties in the file
wp_profile_root/PortalServer/wcm/config/portletconversion.properties
.Note: If the following conditions are true, no changes are required and you can use the default values in the properties file.- There are no clones of the Portal API Web Content Viewer.
- You want to convert all instances of the portlet on all pages in the default virtual portal.
For specific situations, you can update the additional properties that are described in the following table.
Table 1. Scenarios for converting the web content viewer portletThis table describes different scenarios for converting the web content viewer portlet. The first column provides details about the scenario, and the second column lists the properties to modify in the portletconversion.properties file. Scenario Properties to modify You want to convert instances of the portlet on specific pages in the default virtual portal. pages.uniquename Specify a list of unique names of pages, separated by commas. If you specify this property, only portlets on these pages and their descendants are converted. If this property is empty or missing, instances of the Portal API web content viewer on all pages are converted.
You want to convert instances of the portlet in a virtual portal that is not the default virtual portal. xmlaccess.url Specify the URL of the virtual portal to the portal XML configuration interface servlet. You can use this property to run conversions for specific virtual portals. If this property is empty or missing, the default portal is used to run the conversion.
Example:
xmlaccess.url=http://www.example.com:10039/wps/config/vp1
You cloned the web content viewer portlet and want to convert instances of the clone. Identify the clone by specifying one of the following properties: - ibmportlet.portletname
- ibmportlet.uniquename
- ibmportlet.objectid
For a complete list of properties for the portlet conversion task, see Converting portlet instances and settings from the Portal API to the standard API.
- Change to the directory
wp_profile_root/ConfigEngine
. - Run the task ConfigEngine convert-wcm-rendering-portlet.
- Windows™
- ConfigEngine.bat convert-wcm-rendering-portlet
- AIX®, HP-UX, Linux™, Solaris
- ./ConfigEngine.sh convert-wcm-rendering-portlet
- IBM® i
- ConfigEngine.sh convert-wcm-rendering-portlet
- z/OS®
- ./ConfigEngine.sh convert-wcm-rendering-portlet
- Verify the conversion by reviewing the console. The message Build successful indicates a successful conversion. If the message Build failed is displayed upon completion of the task, review the previous steps.
- Verify the configuration of the converted Web Content Viewer. For more information about configuring a local Web Content Viewer, see the portlet help.
- After the successful conversion, you can uninstall the Portal API Web Content Viewer.
What to do next
- Edit the file wp_profile_root/PortalServer/wcm/config/portletconversion.properties.
- Change the following parameters as described here:
- ibmwebapp.uid
- The default value for this parameter is the unique identifier of the Portal API
Web Content Viewer. Change the value to match the unique identifier of the Portal
API Remote Web Content Viewer:
com.ibm.workplace.wcm.app.ui.portlet.RenderingPortlet.30f9cb100a340018159bfdc657811d2e2
- ibmportlet.portletname
- The default value for this parameter is the portlet name of the Portal API Web
Content Viewer. Change the value to match the portlet name of the Portal API
Remote Web Content Viewer:
Remote Web Content Viewer
.
- Perform steps 1 - 5 of the procedure that is given earlier.
- Verify the configuration of the converted Remote Web Content Viewer portlet. For further information on configuring a local Web Content Viewer portlet, read Editing the settings of a web content viewer portlet.
- After the successful conversion, you can uninstall the Portal API Remote Web Content Viewer portlet.