Oracle® Fusion Middleware

Release Notes for Oracle WebCenter Portal

12c (12.2.1.1)

E76089-02

April 2017

1.1 Release Notes for Oracle WebCenter Portal

Learn about the issues you may encounter when using Oracle WebCenter Portal and how to workaround them.

Topics:

- New Features

- Certification Information

- Product Documentation

- Oracle Support

- Deprecated Features

- Issues Related to Installing and Configuring Oracle WebCenter Portal

- Issues Related to Patching and Upgrading Oracle WebCenter Portal

- Issues Related to Mobile Applications

- General Issues and Workarounds

1.1.1 New Features

For an overview of the new features and enhancements for Oracle WebCenter Portal, see What's New for Oracle WebCenter Portal.

1.1.2 Certification Information

To see versions of platforms, supported browser and related software for which Oracle WebCenter Portal is certified and supported, go to http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html.

1.1.3 Product Documentation

For complete documentation on Oracle WebCenter Portal go to http://docs.oracle.com/en/middleware/

1.1.4 Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support at https://support.oracle.com.

1.1.5 Deprecated Features

The following features are deprecated in WebCenter Portal 12c (12.2.1):

Deprecated Features

Notes

E2.0 Producer

Use ADF task flows, including WebCenter Portal task flows.

Folders_g as WebCenter Content Foldering Service

Migrate to Framework Folders.

Support for IBM DB2 Database

Support for IBM DB2 Database is deprecated.

Support for IBM WebSphere

Support for IBM WebSphere is deprecated.

Support for Microsoft Desktop Integration

Migrate to Framework Folders and leverage the WebCenter Content Desktop Integration feature.

Support for Microsoft Exchange Server 2003

Oracle recommends that you upgrade to Microsoft Exchange Server 2007 and higher versions.

Support for Microsoft Office Communicator R1

Oracle recommends that you upgrade to Microsoft Office Communicator R2.

Support for OES 10g Dynamic Role

Support for OES 10g Dynamic Role is deprecated.

Support for Oracle Portal Adapter

Support for Oracle Portal Adapter is deprecated.

Support for Personalization Server

Support for Personalization Server is deprecated.

Support for Trinidad Render

Use default ADF renderer instead.

WebCenter Portal Activity Graph

Activity Graph feature is deprecated.

WebCenter Portal Live Search

Enable Oracle Secure Enterprise Search to search portal objects in WebCenter Portal.

WebCenter Portal Page templates prior to 11g PS3 Release (11.1.1.4.0)

After you upgrade to 12c, update your portal to use the new built-in page templates.

WebCenter Portal Polls and Surveys

Polls and Surveys tools are deprecated.

WebCenter Portal Recent Activities task flow

Use the Activity Stream task flow.

WebCenter Portal Rich Text Portlet

Use ADF rich text editor instead.

WebCenter Portal Worklist task flows

Worklist task flow is deprecated.

Web Clipping Portlet

Use WebCenter Pagelet Producer instead.

1.1.6 Issues Related to Installing and Configuring Oracle WebCenter Portal

Install Secure Enterprise Search in a Separate Oracle Home

Bug: 18398641

Platform: All

Installing Secure Enterprise Search (SES) 11.2.2.2 into the same Fusion Middleware home as WebCenter Portal 11.1.1.7 and above is not supported. The recommended and supported topology is to install SES into a separate Fusion Middleware home. That is, treat SES 11.2.2.2 as a remote service for WebCenter Portal.

Irregular Translation When IE 10 or 11 Browser Is Set to Some Chinese Language Locales

Bug: 19566825

Platform: All

This note refers to more recent versions of the Internet Explorer browser 10+. These browsers support BCP47 style language tags, such as the Chinese locales zh-Hans-SG, zh-Hans-CN, zh-Hant-HK, zh-Hant-MO, and zh-Hant-TW.

If you set your browser language to zh-Hans-SG, zh-Hant-HK, or zh-Hant-MO, and the same language is not set in WebCenter Portal, you will likely see translation inconsistencies on a page. For example, some WebCenter Portal user interface elements may default to the locale selected for the server; some content may default to Traditional or Simplified Chinese.

Workaround: Set your IE 10+ browser locale to zh-Hans-CN or zh-Hant-TW, or select a language preference through the WebCenter Portal UI under user preferences. You can also select your preferred language from the WebCenter Portal login UI.

1.1.7 Issues Related to Patching and Upgrading Oracle WebCenter Portal

Top Banner Not Rendering Correctly

Bug: 16786746

Platform: All

In Oracle WebCenter Portal, when you open a portal that was upgraded from a previous 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].

Workaround: 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.

1.1.8 Issues Related to Mobile Applications

Unable to View Entire Content on iPad Because Scrollbars Not Shown

Bug: 14488651

Platform: iOS (mobile)

The Apple iOS platform does not use scrollbars. When you view a page on an iPad, content may appear truncated because scrollbars are not shown. Also, iFrame components ignore dimensions on an iPad.

Workaround: To view the entire content area, use the two-finger scroll gesture on your iPad.

RSS Links Not Working Properly on iPad

Bug: 14487974

Platform: iOS (mobile)

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 of your firewall, RSS links cannot be viewed.

Cannot Upload Content Using iPad

Bugs: 14488559 and 14487904

Platform: iOS (mobile)

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.

Cannot Copy Text on a Page Using iPad

Bug: 14488336

Platform: iOS (mobile)

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

Mobile Page Variants Not Displayed Correctly on Nexus 4 Devices

Bug: 16954597

Platform: Mobile

Mobile page variants are not displayed on the Nexus 4 devices.

Workaround: 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.*

1.1.9 General Issues and Workarounds

SQL Query with NCHAR Data Type Throws Exception

Bug: 12956478

Platform: All

When using a SQL data control, you may encounter an error if the query contains a column with the NCHAR data type.

Workaround: You can workaround this issue by using the to_char (NCHAR_COLUMN NAME) function.

Cannot Customize or Personalize a JSF Portlet

Bug: 13331428

Platform: All

When you click OK after customizing or personalizing a JSF portlet (that is, a portlet created using the Oracle JSF Portlet Bridge), the portlet produces a time-out message and ceases to respond. This occurs when performing two actions in single operation (editing and then changing the portlet mode).

Workaround: First perform the edit action and click Apply (instead of OK), and then click Return to change the portlet mode back to View mode. Portlet developers can avoid the issue entirely by editing the code for the generated Edit Defaults mode in the edit_defaults.jspx file and the Edit mode in the edit.jspx file: Remove the code for the OK button so users must use Apply.

Embedded Images Not Rendered in the Mail Task Flow

Bug: 14407330 (Enhancement Request: 14552633)

Platform: All

The Mail task flow does not render embedded images. Emails that contain inline images show them as attachments rather than render them within the message body.

Error When Page Name Includes a Space

Bug: 16977809

Platform: All

When accessing a portal page on a device, such as a tablet or iPhone, an issue arises when all of the following conditions are true:

- The page name has a space

- 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 listed conditions are true, the content of the page appears (without the page title) on the device in lieu of the Page Not Available message.

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 Building Portals with Oracle WebCenter Portal.

Unable to Edit Box Properties

Bug: 20356197

Platform: All

Building Portals with Oracle WebCenter Portal discusses Working with Web Development Components on a Page. Note that Box components cannot be modified or deleted since the View Actions menu is not rendered.

Error While Re-running Portlet Application on IntegratedWebLogicServer

Bug: 21876587

Platform: All

When you attempt to run a portlet application (such as a JSR 286 Portlet or Portlet Bridge application) on the IntegratedWebLogicServer more than one time, you get the following deployment error:

There is more than one webservice with the name of "{urn:oasis:names:tc:wsrp:v1:wsdl}WSRP_v1_Service".

Resolve this issue by not running the portlet application again. Instead, deploy the application's EAR deployment profile to the IntegratedWebLogicServer by creating an Application Server Connection to the IntegratedWebLogicServer.

Administrator Console Skin Does Not Load Properly

Bug: 21933886

Platform: All

The Administration Console Skin does not load correctly after updating the Default Page Template and Application Skin to a custom page template and custom skin. This issue appears when attempting to restart the portal server, and may create difficulties when attempting to perform administrative operations such as clicking on a portal template, or when creating a new portal.

To resolve this issue, create a new skin at the shared asset level and then log in. The new skin is simply used for a one-time triggering of skin registration, and can be deleted afterwards.

Connection Timeout Occurs when a WebCenter Portal Server Connection is Created in a Production Environment

Bug: 21982436

Platform: All

When creating a WebCenter Portal Server connection, you enter the host name and port number for the Portal Server you are connecting to. For the host, you can enter either the fully qualified domain name, localhost, or the server name. When the Portal Server is a cluster in an enterprise deployment topology, use the host name and port of the individual server node and not that of the load balancer.

Secured Portlets Return the Remote Portlet Communication Error

Bug: 21943690

Platform: All

When you try to access a secured portlet, it returns the remote portlet communication error. To work around this issue:

1. Log on to Enterprise Manager Fusion Middleware Control.

2. From the Weblogic Domain menu, select Security, then Credentials.

3. Expand the webcenter-1111 folder.

4. Select the key for the WSRP portlet producer connection. For example, if WSRP connection name is wsrp1, the credential key is anonymous#wsrp1-wsconn.

5. Click Edit.

6. For the keystore.type property, specify the value KSS.

7. Click OK.

8. Restart the WC_Portal and WC_Portlets managed servers.

WebCenter Portal JDeveloper Extension Names Modified

Bug: 23637247

Platform: All

JDeveloper Extension names/IDs in Oracle WebCenter Portal are updated:

- WebCenter Core Design Time (oracle.webcenter.core) is changed to WebCenter Core Design Time (oracle.webcenter.common).

- WebCenter Framework and Services Design Time (oracle.webcenter.app) is changed to WebCenter Portal Design Time (oracle.asset-publishing-ext).

Note:

This change is applicable only if you are upgrading from Oracle WebCenter Portal 11g installation and not for a fresh installation.

Warning Displayed When Installing the WebCenter Core Design Time Extension for JDeveloper

Bug: 21968195

Platform: All

When restarting JDeveloper after installing the WebCenter Core Design Time extension, you can ignore the following warning message:

Installing updates...
oracle.ideimpl.deferredupdate.task.InstallExtensionTask perform
WARNING: No Extensions In Bundle: .../oracle.webcenter.wccore_bundle.zip

Installing WebCenter Portal JDeveloper Extensions from Local File

Bug: 21968195

Platform: All

When installing the WebCenter Portal extensions for Oracle JDeveloper by using the Install From Local File option, you must install the WebCenter Core Design Time extension first and restart JDeveloper before installing the WebCenter Portal Design Time extension.

Analytics Collector Not Accessible on the Second Node

Bug: 21463877

Platform: All

When starting servers in a cluster topology, you must allow one server to completely start and be in the Running mode before attempting to start other servers. You can then start all the other servers simultaneously. This is required only when you start the servers for the first time after a fresh WebCenter Portal installation. If you start all the servers simultaneously, Analytics Collector might not be accessible on the other nodes in the cluster.

Document Service Operations Fail When Using JAX-WS Connections to Content Server

Bug: 21929314

Platform: All

If WebCenter Portal uses the JAX-WS connection to Content Server, certain document service operations, such as service provisioning, might fail if the WebCenter Portal instance is not used for some time. To work around this issue, restart the WC_Portal managed server and perform the operation again.

Use createContentServerConnection to Create a JAX-WS Connection to Content Server

Bug: 21929314

Platform: All

If you create a JAX-WS connection to Content Server using Enterprise Manager Fusion Middleware Control, logging into WebCenter Portal returns an internal server error. To work around this issue, instead of Fusion Middleware Control use the createContentServerConnection WLST command to create the JAX-WS connection to Content Server.

Unable to Delete Pages With SubPages in WebCenter Portal Installed with SQL Server

Bug 21835983/Support Note 2061433.1

Platform: All

In a WebCenter Portal instance using SQL Server, when you try to delete a page with subpages, the page will still exist in the UI but the following error is shown in the managed server logs:

oracle.webcenter.portal.transaction.TransactionException: An error occurred executing a transactional method.
at
oracle.webcenter.portal.persistence.transaction.TransactionManagerImpl.execute (TransactionManagerImpl.java:295)
...

Caused by: java.sql.SQLIntegrityConstraintViolationException: [FMWGEN][SQLServer JDBC Driver][SQLServer] The DELETE statement conflicted with the SAME TABLE REFERENCE constraint "WC_PORTAL_ENTITY_SEC_ENTITY". The conflict occurred in database "certdb", table "MSSQLCERT_WEBCENTER.WC_PORTAL_ENTITY", column 'SECURITY_ENTITY_ID'.

To work around this issue:

1. Connect to the SQL Server using the WebCenter schema.

2. Drop the trigger WC_PORTAL_ENTITY_SEC_ENTITY_TRIGGER.

3. Recreate the trigger as follows:

CREATE TRIGGER WC_PORTAL_ENTITY_SEC_ENTITY_TRIGGER ON WC_PORTAL_ENTITY
INSTEAD OF DELETE AS
UPDATE WC_PORTAL_ENTITY SET SECURITY_ENTITY_ID = NULL WHERE SECURITY_ENTITY_ID IN (SELECT ID FROM DELETED)
DELETE FROM WC_PORTAL_ENTITY WHERE ID IN (SELECT ID FROM DELETED);

4. Delete the page again in WebCenter Portal.

Unable to Modify displayName for Resources Using REST APIs

Bug 18631878

Platform: All

The displayName parameter is a derived parameter and cannot be modified directly for any resources by using REST APIs.

Workaround: You need to modify the name parameter.

Query Parameter for a Portal Using REST API

Bug 18631878

Platform: All

The REST API documentation states that the q search query parameter can accept the following value: NameNamespaceQuery;name:;namespace: portal. However, you can also search for portals using the following parameters:

“NameDescriptionLikeQuery;name:Query" (Search using Portal name)

"SinceQuery;date: yyyy-mm-dd'T'HH:mm:ss.SSS'Z' (Search using created date)

Where,

- yyyy-mm-dd refers to the year, month, date format

- HH:mm:ss.SSS refers to the time in the hour, minutes, and seconds format

- Z refers to the zone designator with or without offsets

Example: SinceQuery; date:2015-04-07T02:28:01.815-07:00

For more information, see REST API Reference for Oracle WebCenter Portal.

Post or Put Request Using REST API in Pagelets Fails

Bug 20634297

Platform: All

When you initiate a Post or Put request using REST API in pagelets, the 500 Internal Server Error message is displayed.

Workaround: Use Content-Type as "application/x-www-form-urlencoded" in the request header while invoking the pagelet REST API.

Unable to Create a Navigation Node Using POST in REST API

Bug 23328326

Platform: All

When you try to create a navigation node using the POST method in REST API, the create operation fails with a 403 Forbidden error message. This is a known issue.

EL Expressions are Not Supported in REST APIs

Bug: 23751693

Platform: All

Webcenter objects having EL expressions cannot be accessed using REST APIs as EL expressions are not supported with REST.

Page Navigation Fails if the First Navigation Item is a Link

Bug 22607786

Platform: All

If a link is specified as the first navigation item in the navigation model of a portal, page navigation fails. This is a known issue.

1.1.10 Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Oracle® Fusion Middleware Release Notes for Oracle WebCenter Portal, 12c (12.2.1.1)

E76089-02

Copyright © 2012, 2017, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Describes information about known software issues and their workarounds for this release of Oracle WebCenter Portal.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2018, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Pre-General Availability Draft Documentation Notice

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Pre-General Availability Draft Documentation Notice

If this document is in private pre-General Availability status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your pre-General Availability trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.