12 Oracle WebCenter

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

12.1 General Issues and Workarounds

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

12.1.1 Using Oracle WebLogic Communications Server

Oracle WebLogic Communications Server (OWLCS) is provided as a sample for development only. It should not be used for production deployments.

12.1.2 Using Jive Forums Documentation

Oracle WebCenter Discussions (Jive Forums) is an optional component of Oracle WebCenter. Complete documentation for Jive Forums is included for reference. However, Jive software installations and upgrades outside of the WebCenter product installation are not supported.

12.1.3 Troubleshooting Service Provisioning Issues

When you create a group space, an error similar to the following might be seen if provisioning a service exceeds the time allowed:

Group space created with the following warnings:

Issues were faced while provisioning the services.
Errors were encountered for the following services - Discussions and Announcements. Check if these services have been configured correctly.

When a group space is created, services are provisioned in parallel in multiple threads. If provisioning a service exceeds the specified timeout, the thread is interrupted. The timeout may be exceeded due to time needed to copy the metadata when the latency between the midtier and the database is too high, network issues, database performance issues, and so on.

To check if the issue is due to exceeding the timeout, search the log file for a message similar to the following:

<Nov 3, 2009 4:44:06 PM GMT> <Warning> <oracle.webcenter.webcenterapp> <BEA-000000> <Concurr: The thread is timed out in 10000 milisec. 
for oracle.webcenter.collab.forum:Execution timedout
queued :     12 ms
suspended :    0 ms
running : 5842 ms
timeout : 5000 ms
service : oracle.webcenter.community
resource : oracle.webcenter.collab.forum
source : oracle.webcenter.concurrent.RunnableTask@23268a92 (oracle.webcenter.concurrent.RunnableTask) submission : 15>

<Nov 3, 2009 4:44:06 PM GMT> <Warning> <oracle.webcenter.webcenterapp> <BEA-000000> <Concurr: The thread is timed out in 5000 milisec. 
for oracle.webcenter.collab.announcement:Execution timedout
queued :   37 ms
suspended :    0 ms
running : 5875 ms
timeout : 5000 ms
service : oracle.webcenter.community
resource : oracle.webcenter.collab.announcement
source : oracle.webcenter.concurrent.RunnableTask@37538945 (oracle.webcenter.concurrent.RunnableTask) submission : 18>

<Nov 3, 2009 4:44:06 PM GMT> <Warning> <oracle.webcenter.collab.forum.internal.jive.CategoryTaxanomyCreator> <BEA-000000>
 <java.io.InterruptedIOException: Operation interrupted

In this case, the running time of 5875 ms exceeded the timeout of 5000 ms. The root cause of the timeout should be addressed; for example, resolve networking or database performance issues.

The networking issues could be resolved by incresing the TCP/IP timeout value.To change the timeout values, log in as a root user and execute the following command:

ndd -set /dev/tcp tcp_time_wait_interval 480000 (default value is 60000)

Restart the Administration and Managed Servers. Once this is done, the group space can be created again and the error will not be encountered. If the performance cannot be improved and the error persists, the timeout value may be increased for the service encountering the error. For more information, see Section A.5.5, "Configuring Concurrency Management."

12.1.4 Application Role Names Cannot Include Thai Characters

In this release, application role names cannot contain Thai characters.

12.1.5 Pagelet Producer Failover Support

Oracle WebCenter 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.

12.1.6 File Upload Browse Button Not Selectable with Enter Key (Accessibility Issue)

In Internet Explorer 7 or Firefox, when you select the Upload action on the Documents page or in a Documents service task flow, you are not able to specify a file by pressing the Enter key to select the Browse button:

  • In Internet Explorer 7, this action opens the File Upload dialog to select a file, but when you select the Upload button, an error message displays "Please verify your upload data" and the selected file is removed from the Document to Upload field.

  • In Firefox: This action has no effect.

As a workaround in both Internet Explorer 7 and Firefox, press the spacebar to select the Browse button.

12.1.7 Configuring a Client Security Policy for Oracle Content Server Connections

If your environment supports Global Policy Attachments (GPA), leave the Client Security Policy property blank when you configure the Oracle Content Server connection. The hint text and online help indicates that you must enter the value 'GPA' but this information is not correct. See also, the table "Oracle Content Server Connection Parameters" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

12.1.8 Importing Space Templates with Public Access

When a Space template with public access is imported into another instance of WebCenter Spaces, the template appears as public but the grants are not imported properly. Creating a Space based on this template by using the UI works fine, but creating a Space by using the WebService call fails with an exception.

As a workaround, in the Spaces UI, revoke the public access from the template, and then grant the public access again.

12.1.9 Task Flow Customizations Saved Automatically

Customizations made to task flows created at runtime are base document edits, and therefore, cannot be reset. Consequently, when editing a task flow created at runtime in Oracle Composer, customizations are saved even if you do not explicitly click Save.

Although the Reset Task Flow button is displayed for runtime task flows, it is does not reset customizations.

12.1.10 Option to Create a Portal Resource Displayed for Design-Time Task Flows

You can bring runtime task flows into JDeveloper, edit them, and export them back to the deployed application. However, Oracle recommends that you not expose task flows created in JDeveloper as portal resources. When you create an ADF task flow inside the /oracle/webcenter/portalapp folder, the context menu on the task flow definition file displays the Create Portal Resource option. Do not use this option to expose a design-time task flow as a portal resource. Task flows typically involve multiple files. When you export a new task flow from JDeveloper, all files may not be exported properly, and this may result in the task flow being broken post deployment.

12.1.11 Reading Items in the Resource Catalog (Accessibility Issue)

If you use a screen reader, when you are adding resources from the Resource Catalog, JAWS announces all Resource Catalog items as "Add". This makes it difficult to identify the selected resource. To work around this issue, press the Tab key to get to the Add link for the resource, then press the Down Arrow key. JAWS then reads the description of the resource.

12.1.12 Connections Network Task Flow on System Pages Not Supported

If you include the Connections Network task flow in a custom Resource Catalog and use that catalog in your application, and then try to add this task flow to a system page, you get an error. This error prevents you from editing any other task flow on the page. To work around this issue, click the Restore Default link on the system page to undo all changes made to the page, including removal of the Connections Network task flow.

12.1.13 Cannot Log In to WebCenter Spaces if Oracle BPM is Down

If the WebCenter domain has been extended using the Oracle BPM Spaces template, and Process Spaces has been installed, any attempt to log in to WebCenter Spaces throws exceptions if the Oracle BPM server is down.

12.1.14 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.

12.1.15 Modifying Default Resource Strings for Language Support

In a WebCenter Portal application, to provide language support for component properties edited at runtime, Oracle Composer enables users to edit resource strings for properties that take String values. At runtime, when you try to override the default content in the resource bundle by directly entering values in the Select Text Resource dialog, the changes do not take effect and the page may appear blank.

The workaround is to create a new resource string instead of directly entering values in the Select Text Resource dialog. To create a new resource string, use the Create link in the Select Text Resource dialog and enter the required values in the search results table. Clicking the Use button in the last column selects this string for use as the current property value. For information, see the "Edit Resource Strings" section in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter."

12.1.16 Setting Up WNA-Based SSO Using JDK 1.6.22 Produces an Error

Setting up Windows Native Authentication-based single sign-on using SUN JDK 1.6.22 produces an error. Use the jrockit JDK instead of the Sun JDK, or contact Oracle Support to get a backport request for bug 10631797.

12.1.17 Unable to Edit General Options Through WebCenter Spaces Administration

If you upgrade a WebCenter Spaces application in which the display order of business role pages was customized, you may find that you cannot edit options on the Administration-General page. To workaround this issue:

  1. Use WLST to export the base document webcenter-config.xml:

    exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/webcenter-config.xml')
  2. Delete or comment out the : <br-pages-sequence> node.

    For example, remove:

  3. Save the changes.

  4. Use WLST to import the modified file back to MDS.

    importMetadata(application='webcenter', server='WC_Spaces', fromLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/webcenter-config.xml')

12.1.18 Cannot Navigate to the Current Page Using Out-of-the-Box Navigation Task Flows in WebCenter Portal Applications

Navigating to the same page as the current page with the out-of-the-box navigation task flows fails in WebCenter Portal applications.

The workaround for this issue is to extend the CustomPortalNavigation class and register it in web.xml.

  1. Create a new Java class in your Portal project that extends oracle.webcenter.portalframework.sitestructure.PreferencesBean.

    For example:

    package portal;
    import oracle.webcenter.portalframework.sitestructure.PreferencesBean;
    public class CustomPortalNavigation extends PreferencesBean {
         public CustomPortalNavigation () {
  2. Register this new Java class in web.xml with the navigation framework as a CustomPortalNavigation as follows:


12.1.19 Login Outcome Fails to Navigate to Privileged Pages

If an application is configured to automatically navigate to a page that is accessible only to authenticated users, login to the application fails to navigate to the target page. The browser either shows an empty popup or 404 error.

The workaround for this issue is as follows:

  1. Create a Java class in the application that extends the framework's CustomViewHandler and overload the getActionURL method, for example:

    package portal;
    import java.beans.Beans;
    import javax.faces.application.ViewHandler;
    import javax.faces.context.FacesContext;
    import oracle.webcenter.portalframework.sitestructure.SiteStructure;
    import oracle.webcenter.portalframework.sitestructure.SiteStructureContext;
    import oracle.webcenter.portalframework.sitestructure.SiteStructureResource;
    import oracle.webcenter.portalframework.sitestructure.SiteStructureUtils;
    import oracle.webcenter.portalframework.sitestructure.handler.CustomViewHandler;
    public class ApplicationViewHandler extends CustomViewHandler {
      public ApplicationViewHandler(ViewHandler viewHandler) {
      * Extend to address issue with bug 11076967 involving login
      public String getActionURL(FacesContext fctx, String viewId) {
        String urlStr = viewId;
        if (Beans.isDesignTime()) {
          return m_baseHandler.getActionURL(fctx, urlStr);
        // Only perform the pretty url lookup if the request was from our
        // navigation processAction
        if (isRequestDrivenByNavigation(fctx)) {
          SiteStructure model =
          if (model != null) {
            SiteStructureResource resource = model.getCurrentSelection();
            if (resource != null) {
              // Bug 11076967
              // Only translate to pretty URL if the viewId is that of the
              // resource.
              // There is a usecase (bug 11076967) where the viewId is
              // the login_success outcome in which case, we shouldn't touch it
              String resourceViewId = findTargetViewId(fctx, resource);
              if (resourceViewId != null &&
                  urlStr = "/" +
        // Get the base handler to tag on anything else that might be needed
        // which includes the _adf.ctrl-state
        String ret = m_baseHandler.getActionURL(fctx, urlStr);
        return ret;
  2. Register the above view handler with JSF in faces-config.xml, replacing the existing oracle.webcenter.portalframework.sitestructure.handler.CustomViewHandler entry:

    <faces-config version="1.2" xmlns="http://java.sun.com/xml/ns/javaee">

12.1.20 Links in Page Templates to the Administration Page No Longer Work on an Upgraded Instance

The URL for the Administration Page has changed in, therefore any hardcoded links in page templates that point to the Administration Page must be changed to use the new URL:


Alternatively, create a new page template and use the Administration link Spaces component to link to the Administration Page without having to explicitly provide a URL.

12.1.21 Space Language Does Not Take Effect

If users change their language preference, it overrides the language selected for the Space. To display the language selected for the Space, users must clear the browser cookies and reload the Space.

12.1.22 Performing Security-Related Operations on Business Role Pages

Seeded business role pages, such as Activities and Spaces, are available to all users by default. Currently, the WebCenter Spaces UI does not provide a means of performing security-related operations on seeded business role pages. This means you cannot hide seeded business role pages from all users through the WebCenter Spaces UI. However, there is a workaround:

  1. Export the pages.xml files for anonymous-role and authenticated-role from MDS.

  2. Go through these pages.xml files and, based on your requirement, mark business role pages hidden or shown:

    <!-- Business Role Pages -->
    • Set hidden="true" for the pages that should not be shown.

    • Set hidden="false" for pages that should be shown.

  3. Upload the changed files back to the repository.


12.1.23 Unable to Access SSL-Protected WebCenter Endpoints

An Oracle WebCenter Source (for searching WebCenter Spaces objects, such as lists, pages, Spaces, and people connections profiles) currently cannot access SSL-protected WebCenter endpoints. Oracle is working on a patch for this.

12.1.24 Unable to Export Content to Excel by using a Custom ADF Taskflow

In a WebCenter Portal application that contains a custom ADF taskflow that enables you to generate a downloadable Excel spreadsheet, the export operation may fail when you click the Export to Excel button for the first time. If you encounter this problem, try to export the content to Excel again.

12.1.25 Errors for Activity Graph Queries When the Activity Graph Engines are Running

The process of building and storing similarity scores for Activity Graph can consume a large amount of temporary and undo table space when the size of the graph grows large. To prevent errors, ensure that the temporary and undo tablespaces assigned to the Activities schema are configured to auto-extend.

12.1.26 Page Not Found Error When Clicking Back to Portal Link

The Back to Portal link redirects to http://server:port/contextroot. The default value in web.xml for this is /index.html and the default value in index.html redirects to ./faces/pages_home. If there is no pages_home node in the selected default navigation model for the application, this results in a page not found error. To resolve this issue, update web.xml and index.html to reflect the structure of your application.

If your application uses dynamically created navigations at runtime, it is advisable to change the landing page to be a .jsp page. This enables you to drive the actual node to redirect to within the navigation from a backing bean. The bean can either choose to go to the first navigable page, or can navigate to a node based on an external ID. In the latter case, you must set the external ID in the navigation model.

12.1.27 Turning Off Automatic Event Listening in WebCenter Spaces

In WebCenter Spaces, when a portlet is added to a page, the portlet binding is configured to automatically listen for parameters and events generated on the page. Currently, there is no way to turn off this automatic parameter and event listening in the WebCenter Spaces UI.

To turn off automatic parameter and event listening:

  1. Export the Space.

  2. In JDeveloper, open the page definition for the page containing the portlet.

  3. Edit the portlet binding to set the listenForAutoDeliveredPortletEvents and listenForAutoDeliveredParameterChanges attributes to false:

    <portlet id="p2_1"
  4. Import the Space back into WebCenter Spaces.

12.1.28 Applying Item Level Security On WebCenter Spaces Content

In WebCenter Spaces, using ILS as the primary security mechanism for a Space may become difficult to administer when the number of users grow. Moreover, ILS may not be as efficient as the Space security model. Therefore, Oracle recommends using ILS only to define security for the documents or folders that do not fit within the Space security model. For example, documents and folders to which only a restricted set of users have access. For information about security, see the section "Managing Roles and Permissions for a Space" in Oracle Fusion Middleware User's Guide for Oracle WebCenter Spaces.