14 Oracle WebCenter Portal

This chapter describes issues associated with Oracle WebCenter Portal. It includes the following topic:


For release notes related to WebCenter Portal installed on IBM WebSphere, see Chapter 7, "Oracle Fusion Middleware on IBM WebSphere."

14.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

14.1.1 Installing the WebCenter Portal Extension Version for JDeveloper

The WebCenter Portal extension is an add-in that provides JDeveloper with the complete set of WebCenter Portal capabilities and features. Oracle WebCenter Portal works only with WebCenter Portal extension and Oracle JDeveloper By default, JDeveloper will recommend you to download the WebCenter Portal extension for release as it is the latest version. You must ensure that you have the correct version installed. For information about installing the extension, see the "Installing the WebCenter Portal Extension for JDeveloper" section in Oracle Fusion Middleware Developing Portals with Oracle WebCenter Portal and Oracle JDeveloper.

14.1.2 Support for Discussions Server from Jive Software

Oracle supports the embedded discussions server from Jive Software. Use the supplied task flows that come with WebCenter Portal to call this discussions server. Any custom development against APIs in the Jive Web Service layer are subject to review by Oracle and may not be supported.

There are a limited set of beta features that Jive Software delivers as part of the discussions server that Oracle does not recommend and cannot yet support.

Documentation for Jive Forums is included for reference only. Jive software installations and upgrades outside of the WebCenter Portal product installation are not supported.

14.1.3 Oracle WebCenter Portal's Pagelet Producer Failover Support

Oracle WebCenter Portal's Pagelet Producer supports failover in a clustered configuration. However, the in-flight data (unsaved or pending changes) is not preserved. On failover, administrators must reestablish their administrative session. End users may also need to reestablish the session if the proxy is required to have a state. If SSO is configured, credentials are automatically provided, and the session is reestablished.

14.1.4 SQL Query with NCHAR Data Type Throws Exception

When using a SQL data control, you may encounter an error if the query contains a column with the NCHAR data type. As a workaround, you can use the to_char(NCHAR_COLUMN NAME) function.

14.1.5 Configuring the REST Server Post-Installation

For certain features of the WebCenter Portal REST server to work correctly when using a REST client like the Oracle WebCenter Portal iPhone application, the flag WLForwardUriUnparsed must be set to ON for the Oracle WebLogic Server Plugin that you are using.

  • If you are running Apache in front of WebLogic Server, add this flag to weblogic.conf.

  • If you are running Oracle HTTP Server (OHS) in front of WebLogic Server, add this flag to mod_wl_ohs.conf.

The examples below illustrate the possible configurations for both of these cases.

For more information about how to configure WebLogic Server Plugins, see Oracle Fusion Middleware Using Web Server 1.1 Plug-Ins with Oracle WebLogic Server.

Example 1: Using <location /rest> to apply the flag only for /rest URIs (recommended)

<Location /rest>
  # the flag below MUST BE set to "On"
  WLForwardUriUnparsed    On
  # other settings, example: WebLogicCluster or WebLogicHost & WebLogicPort
  # set the handler to be weblogic
  SetHandler weblogic-handler

Example 2: Applying the flag to all URIs served by Oracle WebLogic Server

<IfModule mod_weblogic.c>
   # the flag below MUST BE set to "On"
  WLForwardUriUnparsed    On
  # other settings, example: WebLogicCluster or WebLogicHost & WebLogicPort
  WebLogicCluster johndoe02:8005,johndoe:8006
  Debug ON
  WLLogFile             c:/tmp/global_proxy.log 
  WLTempDir             "c:/myTemp"
  DebugConfigInfo       On
  KeepAliveEnabled ON
  KeepAliveSecs  15

14.1.6 Cannot Customize or Personalize a JSF Portlet

When clicking OK after customizing or personalizing a JSF portlet (that is, a portlet created using the Oracle JSF Portlet Bridge), the portlet does not respond and displays a timeout message. This is caused by performing an edit action and changing the portlet mode in a single operation. End users can work around this issue by clicking Apply (instead of OK) to perform the edit action first, then clicking Return to change the portlet mode back to View mode. Portlet developers can avoid the issue occurring by editing the code for the generated Edit Defaults mode (in the edit_defaults.jspx file) and Edit mode (in the edit.jspx file) and removing the code for the OK button so that end users are forced to use the Apply button instead.

14.1.7 Portals Do Not Display Correct Language When WebCenter Portal is Accessed Using OAM

When users access WebCenter Portal through OAM, portals do not display the language selected on the OAM login page. WebCenter Portal does not use the same xlf file name standard as OAM.

14.1.8 Announcement Publication Format can be Incorrect in Thai

When the display language is set to Thai, the announcement publication format can be incorrect. This happens when announcements are opened to edit and are then saved, even if nothing in the announcement itself is updated.

14.1.9 The Run as Servlet Link on Producer Test Page Does Not Work for JSF Portlet

You can create a JSF portlet (that is, a portlet that uses the Oracle JSF Portlet Bridge) using the Create JSR 286 Java Portlet Wizard by selecting the Generate ADF-Faces JSPX implementation method on the third step of the wizard.

If you create a JSF portlet in this way, you may find that clicking the Run as Servlet link on the portlet's Producer Test Page produces an error. The portlet itself, however, runs correctly.

To avoid this issue, add the ADF Page Flow scope to the project that contains the portlet. For information, see the "Adding and Removing Technology Scopes" section in Oracle Fusion Middleware Developing Portals with Oracle WebCenter Portal and Oracle JDeveloper.

14.1.10 Using OpenSocial Pagelets to Post Activities to User's Activity Stream

Pagelets based on OpenSocial gadgets are not able to post activities to a user's activity stream. To implement a temporary solution, grant User Profile 'edit' permission to Oracle WebCenter Portal's Pagelet Producer using the following WLST/WSAdmin command:

principalClass="oracle.security.jps.internal.core.principals.JpsAuthenticatedRoleImpl", principalName="authenticated-role",
permTarget="/oracle/webcenter/peopleconnections/profile/s8bba98ff_4cbb_40b8_beee_296c916a23ed/.*", permActions="view,edit")

After running the command, restart the Pagelet Producer server.

14.1.11 Accessing Owners' Profile Information Using the OpenSocial API

To access owners' Profile/Activities/Friends information using the OpenSocial API with Oracle WebCenter Portal's Pagelet Producer, you must target the WebCenterDS data source to the WC_Portlet managed server as described in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. After saving this configuration, Activities and Friends information can be fetched, but Profile information is not returned. To access Profile information, restart the WC_Portlet managed server.

14.1.12 Unable to View Entire Content on iPad as Scrollbars Not Displayed

The Apple iOS platform does not display scrollbars. When you view a page on an iPad, content may appear truncated because scrollbars are not displayed. Also, iFrame components ignore dimensions on iPad. To view the entire content area, use the two-finger scroll gesture on your iPad.

14.1.13 RSS Links Not Working Properly on iPad

The Apple iOS platform renders RSS links by loading them through the site reader.mac.com. If the WebCenter Portal instance is not accessible outside your firewall, RSS links cannot be viewed.

14.1.14 Cannot Upload Content Using iPad

The Apple iOS platform does not support a native file system browser. Therefore, you cannot upload content from an iPad. All upload actions, such as publish, upload, and share are disabled or hidden when you access WebCenter Portal from an iPad.

14.1.15 Cannot Copy Text Displayed on Pages

If you access a page through an iPad, you cannot copy the text displayed on the page. This is a limitation from the Apple iOS platform.

14.1.16 Embedded Images Not Rendered

The Mail task flow does not render embedded images. If an email contains inline images, they are shown as attachments, and not within the message body.

14.1.17 Unable to Check Out a Document When Using Firefox First Time

The first time you access WebCenter Portal using the Mozilla Firefox browser, and attempt to open a document using Desktop Integration over an SSL or HTTPS connection, you will receive a warning that the certificate is not trusted, even if the environment has a valid certificate. You can open the document, but cannot check in or check out the document from within a Microsoft Office application. However, subsequent use of Desktop Integration through the Firefox browser will work as expected and you will be able to check documents in and out from within a Microsoft Office application.

14.1.18 Web Clipping Portlet is Deprecated

The Web Clipping portlet is deprecated in Release 11g ( and should not be used. Instead, create a clipper pagelet using Oracle WebCenter Portal's Pagelet Producer.

14.1.19 Deployment Fails Because Versioned Applications Are Not Supported

Application versioning is no longer supported by default for ADF applications. Upon initial deployment, an existing (or earlier) or new application ( or later) deploys successfully regardless of the application's versioning. However, when redeploying an unversioned application from JDeveloper to a WebLogic Server where a versioned instance of that application is already running, deployment will fail. This is because the server is already running a versioned instance and WebLogic Server does not allow deploying an unversioned instance of the same application. You will see an error message like this:

Weblogic Server Exception: 
weblogic.management.ManagementException: [Deployer:149082]You cannot deploy application 'Application1_application1' without version. The application was previously deployed with version 'V2.0'.

To resolve this issue, undeploy the versioned application first and then deploy the unversioned application.

14.1.20 Exception Reported When Running WC_Spaces Managed Server

When you start the WC_Spaces managed server, the following exception is reported in server logs after the server reaches the running state.

"Could not fetch the default portal configuration from webcenter-config oracle.webcenter.webcenterapp.WebCenterException: Getting WebCenter Attributes "

This does not cause any functionality loss. It is a known issue.

14.1.21 Upgraded Portals Do Not Render Properly

In WebCenter Portal, when you display a portal upgraded from a previous Oracle WebCenter Portal installation, the top banner of the portal does not render correctly. This happens when the portal has a page template set to a specific value, and the skin is left as [System Default]. To work around this issue, you must choose a skin to match the page template. Configure the upgraded portal to use the Spaces FX or Fusion FX skin, depending on the page template.

14.1.22 Displaying a Page on a Device when the Page Name Includes a Space

An issue exists when accessing a portal page on a device (such as a tablet or iPhone) when all of the following conditions are true:

  • The page has a space in its name

  • The page does not have a page variant defined

  • The Page Fallback setting for the page or the portal is Display No Page

In this case, the expected behavior is to see Page Not Available on the device. However, when all of the condition above are true, the content of the page displays (without the page title) on the device instead of Page Not Available.

For more information, see the "Setting Page Behavior for a Portal When No Page Variant Exists" and "Setting Page Behavior for a Specific Page When No Page Variant Exists" sections in Oracle Fusion Middleware Building Portals with Oracle WebCenter Portal.

14.1.23 Problem Integrating PeopleSoft and WebCenter Portal

This release has a known issue when integrating PeopleSoft and WebCenter Portal leveraging WSS1.0 Username Token with Password. This is the recommended approach for customers who require secure consumption of PeopleSoft portlets in WebCenter Portal. Customers should contact Oracle Customer Support to obtain a patch to address this issue.

Oracle does not recommend using WSS1.0 SAML Token with Message Protection. This approach is not supported for integration between WebCenter Portal and PeopleSoft.

14.1.24 Unable to Create Pages in Portals Created Using REST APIs

In a portal created using WebCenter Portal REST APIs, you will face problems creating pages. To work around this issue, you need to reapply Page permissions. Navigate to the Security page in WebCenter Portal Builder Administration. On the Roles tab, deselect all the permissions for Pages and save the setting. Now select the same permissions again and save the settings.

14.1.25 Mobile Page Variants Not Displayed Correctly on Nexus 4 Devices

Mobile page variants are not displayed on the new Nexus 4 devices. To resolve this issue, create a new device with the following user agent string:

Mozilla/5.0 \(Linux; Android.+4.2.+Nexus 4.+Chrome.*Mobile Safari.*

For information about creating new devices and specifying the user agent string, see the "Creating and Managing Devices" section in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

14.1.26 Configuring Oracle SES for Oracle WebCenter Portal

Oracle WebCenter Portal release supports Oracle SES If you patch your existing Oracle SES installation to release, you must install the new version of Oracle WebCenter Portal's Document Service Manager on Oracle SES and configure Oracle SES facets and sorting attributes. For information, see the "Installing Oracle SES" section in Oracle Fusion Middleware Installation Guide for Oracle WebCenter Portal.

14.1.27 Clicking the Create Topic Button in a Discussion Forum Does Not Open the Create Topic Dialog

When you navigate to a discussions page by using its direct URL and pass forumId as a query parameter in the page URL, clicking the Create Topic button in the discussion forum displays a list of forums instead of opening the Create Topic dialog. You encounter this issue when accessing the pages that contain the Discussion Forums task flow with #{param.forumId} set as the value for the Forum ID attribute.

To ensure that clicking the Create Topic button displays the Create Topic dialog, implement the following workaround:

  1. Open the page that contains the Discussion Forums task flow in edit mode in Composer.

  2. Ensure that the View Switcher is set to Data.

  3. On the Source tab, click PageDef at the bottom of the frame.

  4. Locate the task flow binding within the <executables> section of the PageDef source.

    You will notice that this task flow binding has the attribute Refresh="ifNeeded", and one of the input parameters to the task flow binding is "param.forumId".

  5. Delete the attribute Refresh="ifNeeded".

  6. Replace it with the following attribute: RefreshCondition="#{param.forumId!=null}".

  7. Click Save to save the changes.

14.1.28 Duplicate Copies Created when Copying, Moving, or Cutting and Pasting Files and Folders with the Same Name

Duplicate copies of files and folders (prefixed with "Copy of") are created when you "copy and paste", "cut and paste", or "move and paste" to a location that already contains a file or folder with the same name. For example, if you copy or cut the file Events.docx and paste it to a folder containing that file, the new pasted version is named Copy of Events.docx.

This is applicable only when Oracle WebCenter Portal is configured to use FrameworkFolders as the folder service. If Folders_g is configured, files and folders are not duplicated if a matching copy is found at the target.

14.1.29 Invalid Characters in Folder and File Names

If WebCenter Portal is configured to use FrameworkFolders as the folder service, the following characters are not allowed in folder and file names:

? # & / \ * " | < > : î

14.1.30 Comment and Tag Updates Not Listed in Activity Stream of Portal Framework Applications

In a Portal Framework application, when you add comments or tags to a newly uploaded document, these updates are not listed in the Activity Stream of the application. This happens when Oracle WebCenter Portal is configured to use the FrameworkFolders component.

14.1.31 Imprecise Error Message When Uploading a File with the Same Name as a Checked Out File

When a user has checked out a file, and another user tries to upload a new version of the file with the same name, an error message is shown specifying that the user does not have the permission. The error message is not complete as it does not specify that the file has already been checked out by a user. This error is displayed when Oracle WebCenter Portal is configured to use the FrameworkFolders component.

14.1.32 Cannot Create or Move Files by Using CMIS REST API

The feature to create files or folders or move files from one folder to another using the CMIS REST API does not work when FrameworkFolders is enabled as the folder service.

14.1.33 Tabs Not Displayed on Document Management Taskbar

When editing a WebCenter Portal document in Word, Excel, or PowerPoint, the tabs (Status, Members, Tasks, Documents, and Links) do not appear on the Document Management taskbar, which is invoked by clicking on the Office icon > Server > Document Management. The tabs are displayed only after the document has been checked in. This happens when Oracle WebCenter Portal is configured to use the FrameworkFolders component.

14.1.34 Imprecise Error Messages When Renaming or Pasting a File in Workflow

When you try to rename or cut and paste a file that is part of workflow, an error message appears indicating that the file cannot be renamed or moved as it no longer exists. For example, the following error message appears when you rename a file:

"Messages for this page are listed below.
Unable to rename the selected document.
The document no longer exists.
Please refresh to see the latest content (View > Refresh Content)."

This error message is incorrect, and is displayed when Oracle WebCenter Portal is configured to use the FrameworkFolders component. The error message should specify that the file cannot be renamed or moved because it is part of workflow and the user is not added as a reviewer to the workflow.

14.1.35 Unable to Access Files Using Direct URL in Home Portal

In Home portal, accessing a file under Item Level Security using direct URL does not work if you do not have access to all the folders in the chain. This happens when Oracle WebCenter Portal is configured to use the FrameworkFolders component.

14.1.36 Creating a Portal based on a Template Containing Blogs or Wikis

When you create a portal from a portal template that contains blogs and wikis, the blogs and wikis are not displayed in the newly created portal. This happens when Oracle WebCenter Portal is configured to use the FrameworkFolders component.

14.1.37 FrameworkFolders Not Supported When Oracle BPM Process Spaces is Enabled for WebCenter Portal

Oracle BPM Process Spaces requires that Folders_g must be enabled on Content Server. In a new installation of Oracle WebCenter Portal, if you want to enable Process Spaces for WebCenter Portal, you must ensure that Folders_g is enabled and FrameworkFolders is disabled.