Reserved authoring portlet

Web content authoring tasks performed in Web Content Viewer and on web content pages, are performed through a special instance of the authoring portlet reserved specifically for these tasks, and is installed on page, yet hidden from page navigation available to typical users. The following tasks use the reserved authoring portlet:

• Selecting a web content folder when editing the properties of a web content page.
• Configuring the web content viewer, including when selecting the content item to display.
• Perform inline editing using authoring tools components rendered in the web content viewer.

Typically authoring tasks are performed in a separate window that opens from the current page, but we can configure the behavior of authoring tools components to redirect users to the hidden page containing the reserved authoring portlet. If either the authoring portlet instance or the hidden portal page are not available or if the user lacks the permission to access either of them, the authoring tasks requiring the reserved authoring portlet will fail, causing web content pages and the web content viewer to be unusable. For this reason, be careful when administering the reserved authoring portlet and the hidden portal page.

For proper functionality of the reserved authoring portlet:

• Users must have the User role on the hidden portal page.
• Users must have the User role on the reserved authoring portlet.
• The reserved authoring portlet must be the only portlet located on the hidden portal page.
• The unique name of the hidden portal page must be: com.ibm.wps.hiddenpage.wcm.Authoring_Portlet
• The unique name of the portlet window of the authoring portlet instance on the hidden portal page must be: com.ibm.wps.hiddenpage.wcm.control.Authoring_Portlet

Availability problems related to the reserved authoring portlet or the hidden portal page are usually identified by the following symptoms:

• The SystemOut.log file for the portal server contains error messages referencing the authoring portlet or hidden page. For example:
  • EJPDB0124E: The specified string [com.ibm.wps.hiddenpage.wcm.Authoring_Portlet] can neither be deserialized as an object ID nor resolved as a unique name.
  • EJPDB0124E: The specified string [com.ibm.wps.hiddenpage.wcm.control.Authoring_Portlet] can neither be deserialized as an object ID nor resolved as a unique name.

• When a separate window is launched from the current page to perform the authoring task, the new window displays the following message:
  Error 400: EJPPH0006E: The resolution of a URI failed. Refer to the stack trace for more detailed information.

• When a separate window is launched from the current page to perform the authoring task, the new window is empty.

• When the user is redirected to another portal page to perform the authoring task, the user is redirected to the default portal page instead of the page containing the reserved portlet.

• When the user is redirected to another portal page to perform the authoring task, the user is redirected to an empty page.

If the reserved authoring portlet or the hidden portlet page are removed inadvertently, we can deploy them again using...

./ConfigEngine.sh action-install-wcm-hidden-authoring

If you have issues in a virtual portal, we can try...

1. Login to the base portal and go to...
   Administration | Manage Pages | Search by: Unique name contains

2. Enter Search: com.ibm.wps.hiddenpage.wcm.Authoring_Portlet

3. Click the export button to the right and save the xml export

4. Login to the virtual portal

5. Go into Administration

6. Click Import XML under Portal Settings

7. Import the XML from the base portal

Configure the reserved authoring portlet

The reserved authoring portlet is essential to the proper operation of web content pages and the web content viewer, so it is important that the configuration of the reserved authoring portlet reflect similar settings for performing authoring tasks as the configuration of other instances of the Web Content Manager authoring portlet.

1. Log in to the portal as an administrator.
   Administration | Portal User Interface | Manage Pages

2. Search for the page with the unique name of...
   com.ibm.wps.hiddenpage.wcm.Authoring_Portlet

3. Click the Edit Page Layout icon (small pencil) for the page.

4. Select "Edit shared settings" from the portlet menu, and specify any settings for the reserved authoring portlet.

   The available settings and the process for updating them is the same for the reserved authoring portlet as it is for any other instance of the authoring portlet.

   Changes made to the reserved authoring portlet with the "Edit shared settings" mode affect only the reserved authoring portlet and no other instances of the authoring portlet. To ensure a consistent authoring experience, we can make the same changes to other authoring portlet instances using the Edit shared settings mode for each instance. Alternatively, we could make the same changes to every instance of the authoring portlet using the "Configure" mode from a single instance. Changes you make in the Configure mode also affect the reserved authoring portlet.

5. Save the changes.

Parent:

Reserved authoring portlet
Control the behavior of authoring tools components
Defining authoring tools