This chapter describes issues associated with Oracle WebCenter Portal. It includes the following topic:
Note:
For release notes related to WebCenter Portal installed on IBM WebSphere, see Chapter 7, "Oracle Fusion Middleware on IBM WebSphere."
This section describes general issues and workarounds. It includes the following topics:
Section 14.1.1, "Installing the WebCenter Portal Extension Version 11.1.1.8.3 for JDeveloper"
Section 14.1.2, "Support for Discussions Server from Jive Software"
Section 14.1.3, "Oracle WebCenter Portal's Pagelet Producer Failover Support"
Section 14.1.4, "SQL Query with NCHAR Data Type Throws Exception"
Section 14.1.5, "Configuring the REST Server Post-Installation"
Section 14.1.6, "Cannot Customize or Personalize a JSF Portlet"
Section 14.1.8, "Announcement Publication Format can be Incorrect in Thai"
Section 14.1.9, "The Run as Servlet Link on Producer Test Page Does Not Work for JSF Portlet"
Section 14.1.10, "Using OpenSocial Pagelets to Post Activities to User's Activity Stream"
Section 14.1.11, "Accessing Owners' Profile Information Using the OpenSocial API"
Section 14.1.12, "Unable to View Entire Content on iPad as Scrollbars Not Displayed"
Section 14.1.17, "Unable to Check Out a Document When Using Firefox First Time"
Section 14.1.19, "Deployment Fails Because Versioned Applications Are Not Supported"
Section 14.1.20, "Exception Reported When Running WC_Spaces Managed Server"
Section 14.1.22, "Displaying a Page on a Device when the Page Name Includes a Space"
Section 14.1.23, "Problem Integrating PeopleSoft and WebCenter Portal"
Section 14.1.24, "Unable to Create Pages in Portals Created Using REST APIs"
Section 14.1.25, "Mobile Page Variants Not Displayed Correctly on Nexus 4 Devices"
Section 14.1.26, "Configuring Oracle SES 11.2.2.2 for Oracle WebCenter Portal"
Section 14.1.29, "Invalid Characters in Folder and File Names"
Section 14.1.32, "Cannot Create or Move Files by Using CMIS REST API"
Section 14.1.33, "Tabs Not Displayed on Document Management Taskbar"
Section 14.1.34, "Imprecise Error Messages When Renaming or Pasting a File in Workflow"
Section 14.1.35, "Unable to Access Files Using Direct URL in Home Portal"
Section 14.1.36, "Creating a Portal based on a Template Containing Blogs or Wikis"
The WebCenter Portal extension is an add-in that provides JDeveloper with the complete set of WebCenter Portal capabilities and features. Oracle WebCenter Portal 11.1.1.8.3 works only with WebCenter Portal extension 11.1.1.8.x and Oracle JDeveloper 11.1.1.7.0. By default, JDeveloper will recommend you to download the WebCenter Portal extension for release 11.1.1.8.3 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.
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.
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.
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.
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 </Location>
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 </IfModule>
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.
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.
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.
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.
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:
grantPermission(appStripe="pagelet-producer", principalClass="oracle.security.jps.internal.core.principals.JpsAuthenticatedRoleImpl", principalName="authenticated-role", permClass="oracle.webcenter.peopleconnections.profile.security.ProfilePermission", permTarget="/oracle/webcenter/peopleconnections/profile/s8bba98ff_4cbb_40b8_beee_296c916a23ed/.*", permActions="view,edit")
After running the command, restart the Pagelet Producer server.
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.
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.
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.
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.
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.
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.
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.
The Web Clipping portlet is deprecated in Release 11g (11.1.1.8.0) and should not be used. Instead, create a clipper pagelet using Oracle WebCenter Portal's Pagelet Producer.
Application versioning is no longer supported by default for ADF applications. Upon initial deployment, an existing 11.1.1.7.0 (or earlier) or new application (11.1.1.8.0 or later) deploys successfully regardless of the application's versioning. However, when redeploying an unversioned application from JDeveloper 11.1.1.7.0 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.
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.
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.
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.
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.
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.
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.
Oracle WebCenter Portal release 11.1.1.8.0 supports Oracle SES 11.2.2.2. If you patch your existing Oracle SES installation to release 11.2.2.2, 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 11.2.2.2" section in Oracle Fusion Middleware Installation Guide for Oracle WebCenter Portal.
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:
Open the page that contains the Discussion Forums task flow in edit mode in Composer.
Ensure that the View Switcher is set to Data.
On the Source tab, click PageDef at the bottom of the frame.
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"
.
Delete the attribute Refresh="ifNeeded"
.
Replace it with the following attribute: RefreshCondition="#{param.forumId!=null}"
.
Click Save to save the changes.
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.
If WebCenter Portal is configured to use FrameworkFolders as the folder service, the following characters are not allowed in folder and file names:
? # & / \ * " | < > : î
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.
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.
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.
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.
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.
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.
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.
Oracle BPM Process Spaces requires that Folders_g must be enabled on Content Server. In a new installation of Oracle WebCenter Portal 11.1.1.8.3, if you want to enable Process Spaces for WebCenter Portal, you must ensure that Folders_g is enabled and FrameworkFolders is disabled.