Groupware Portlet

WebLogic Portlets for Groupware Integration are Java Page Flow (JPF) portlets that uses Portlet Preferences to control some of the behavior associated with each logical portlet instance. A number of default Portlet Preferences have been defined in the GroupwarePortlets.portlet file.

There are additional Portlet Preferences which can be added to specific instances of the Portlet when configuring the portlet via the WebLogic Administration Console. This section describes the Portlet Preferences associated with WebLogic Portlets for Groupware Integration which are used to configure various capabilities such as features and navigation.

Groupware Portlet Definition

Property	Description	Value
Content URI	This property is the location of the content page flow JPF class.	`/portlets/compoze/content/contentController.jpf`
Edit (optional)	This property is the location of the edit	`/portlets/compoze/content/edit/editController.jpf`

Portlet Preferences

This section describes the various portlet preferences used to configure and customize the portlets.

Feature Groups

For each logical portlet instance, the active features can be configured. By default, all features are active. By modifying, these preferences, a Portal Administrator can deploy multiple logical instances of the Groupware Portlets and configure which feature(s) is available in each instance. The following preferences can be found in the GroupwarePortlets.portlet file and can altered by either modifying the GroupwarePortlets.portlet or by configuring individual Portlet instances while using the WebLogic Administration Console.

Property

Description

Values

groupware.feature.address_book

This preference activates the address book feature.

true/false

groupware.feature.calendar

This preference activates the calendar feature.

true/false

groupware.feature.mail

This preference activates the mail feature.

true/false

groupware.feature.tasks

This preference activates the tasks feature.

true/false

groupware.feature.options

This preference activates the options feature.

Note:

If this feature is disabled, users will have no way of accessing the options feature unless the Edit mode has been enabled for the portlet.

true/false

groupware.feature.home

This preference activates the home feature.

Note:

If this feature is disabled, users will have no way of accessing the home and summary pages. User will be immediately forwarded to the full view of an enabled feature.

true/false

Maximized View Feature Title and Navigation

Each page in the Groupware Portlet includes a title (also referred to as a “header”) at the top. A portal administrator can optionally configure to display this title and if the title is displayed, can configure how navigation is used within the title. Note that all pages in maximized view of the portlet include the same JSP which is used to display the feature title and navigation.

The following preferences determine if the title is displayed for each feature. By default, feature titles are enabled. To disable individual feature titles, the following Portlet Preference must be added to individual instances of the Groupware Portlet via the WebLogic Administration Console and configured to be false.

The title can be configured to support options navigation or features navigation. Options navigation provides a link to the feature options configuration in the title. Features navigation provides links to the features of the Groupware Portlet. This preference can be found in the GroupwarePortlets.portlet file and can altered by either modifying the GroupwarePortlets.portlet or by configuring individual Groupware Portlet instances while using the WebLogic Administration Console.

Each page in the Groupware Portlet also includes a navigation area (also referred to as a “left navigation area”) at the left side of the portlet. A portal administrator can optionally configure to display this navigation area. Note that all pages in maximized view of the portlet include the same JSP which is used to display the left navigation area.

The following preference determines if the left navigation area is displayed for all features. By default, the left navigation area is disabled. This preference can be found in the GroupwarePortlets.portlet file and can enabled by either modifying the GroupwarePortlets.portlet or by configuring individual Groupware Portlet instances while using the WebLogic Administration Console.

Property	Description	Values
`groupware.feature.address_book.title`	This preference activates the titles for the address book feature pages.	true/false
`groupware.feature.calendar.title`	This preference activates the titles for the calendar feature pages.	true/false
`groupware.feature.mail.title`	This preference activates the titles for the mail feature pages.	true/false
`groupware.feature.tasks.title`	This preference activates the titles for the tasks feature pages.	true/false
`groupware.feature.options.title`	This preference activates the titles for the options feature pages.	true/false

Each summary page in the home view of the Groupware Portlet includes two navigation areas: a navigation area (also referred to as a “top navigation area”) at the top and bottom (also referred to as a “bottom navigation area”) of the page. A portal administrator can optionally configure to display the top or bottom navigation areas.

Note that even though the two navigation areas can be displayed simultaneously in two different sections areas of a summary page, it is the same JSP page which is optionally included in the both the top and bottom areas of the page.

Property	Description	Values
`groupware.title. feature_ navigation`	This preference configures the titles to use feature navigation. In order for feature navigation to be enabled in the groupware Portlet title section, feature titles must be configured to be visible in features where title feature navigation will be available.	true/false
`groupware.left_ area`	This preference activates the left navigation area for all maximized feature pages.	true/false

The bottom navigation area preference can be found in the GroupwarePortlets.portlet file and can altered by either modifying the GroupwarePortlets.portlet file or by configuring individual Groupware Portlet instances while using the WebLogic Administration Console. To enable the top navigation area, the following Portlet Preference must be added to individual instances of the Groupware Portlet via the WebLogic Administration Console and configured to be true.

If the top or bottom navigation is enabled in the home views, links will be available for each enabled feature, except Options, which will allow a user to access the Home view of a feature from the Home navigation area. To disallow users from accessing Home views for features, the following Portlet Preference must be added to individual instances of the Groupware Portlet via the WebLogic Administration Console and configured to be false.

Error Reporting

The Groupware Portlet includes specialized areas for handling various error and exception scenarios which may occur in the Groupware Portlet. Depending on the type of error that occurred, the Groupware Portlet may forward to a pageflow which was designed to handle that specific error scenario or to a pageflow which is meant to handle more general error types.

If a general error occurs, the Groupware Portlet will forward to the compoze\content\error\general pageflow. With the default configuration of the Groupware Portlet, general error display page will include an area where a stack trace of the exception that occurred can be viewed.

To configure the Groupware Portlet not to show the exception stack trace on the error page, the following Portlet Preference must be added to individual instances of the Groupware Portlet via the WebLogic Administration Console and configured to be false.

Property	Description	Values
`groupware.feature.home.navigation.bottom`	This preference activates the bottom navigation area for home pages.	true/false
`groupware.feature.home.navigation.top`	This preference activates the top navigation area for home pages.	true/false
`groupware.feature.home.navigation.min`	This preference activates the links for feature home pages in the home navigation area.	true/false
`groupware.error_stacktrace`	This preference hides the area where an exception stack trace can be viewed for error pages.	true/false

Modify a Web-App to Support File Attachments

In order for the Groupware Portlets to support upload of file attachments (for example when sending an email message), you need to configure the multipart handler for netui.

In Workshop for WebLogic Platform, open the beehive-netui-config.xml file found at:

<WebContent>/WEB-INF/beehive-netui-config.xml

Add the following entry in bold text:

<pageflow-config>

<multipart-handler>memory</multipart-handler>

<module-config-locators>

<module-config-locator>

<description>Module locator to support struts applications as portlets.</description>

<locator-class>com.bea.struts.adapter.util.ModuleConfigLocator</locator-class>

</module-config-locator>

</module-config-locators>

</pageflow-config>

Save the config file.

Setup Guide

Groupware Portlet