Setup Guide

Groupware Portlet

WebLogic Portlets for Groupware Integration are Java Page Flow 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 CompozeGroupware.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 Tools Portal. 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

The Groupware Portlet ship with a .portlet file found at:

%COMPOZE_PORTLETS_HOME%\portlets\compoze\CompozeGroupware.portlet

The Content URI and otional Edit URI are as follows:

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 page flow JPF class (optional).	`/portlets/compoze/content/edit/editController.jpf`

Portlet Preferences

This section describes portlet preferences.

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 Portlet and configure which feature(s) is available in each instance. The following preferences can be found in the CompozeGroupware.portlet file and can altered by either modifying the CompozeGroupware.portlet or by configuring individual Portlet instances while using the WebLogic Administration Tools Portal.

Preference	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 forwared 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 Tools Portal and configured to be false.

Preference	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

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 CompozeGroupware.portlet file and can altered by either modifying the CompozeGroupware.portlet or by configuring individual Groupware Portlet instances while using the WebLogic Administration Tools Portal.

Preference	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

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 CompozeGroupware.portlet file and can enabled by either modifying the CompozeGroupware.portlet or by configuring individual Groupware Portlet instances while using the WebLogic Administration Tools Portal.

Preference	Description	Values
`groupware.left_area`	This preference activates the left navigation area for all maximized feature pages.	true/false

Home View Feature Navigation

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.

The bottom navigation area preference can be found in the CompozeGroupware.portlet file and can altered by either modifying the CompozeGroupware.portlet file or by configuring individual Groupware Portlet instances while using the WebLogic Administration Tools Portal.

Preference	Description	Values
`groupware.feature.home.navigation.bottom`	This preference activates the bottom navigation area for home pages.	true/false

To enable the top navigation area, the following Portlet Preference must be added to individual instances of the Groupware Portlet via the WebLogic Administration Tools Portal and configured to be true.

Preference	Description	Values
`groupware.feature.home.navigation.top`	This preference activates the top navigation area for home pages.	true/false

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 Tools Portal and configured to be false.

Preference	Description	Values
`groupware.feature.home.navigation.min`	This preference activates the links for feature home pages in the home navigation area.	true/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 types errors. 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 occured 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 Tools Portal and configured to be false.

Preference	Description	Values
`groupware.error_stacktrace`	This preference hides the area where an exception stack trace can be viewed for error pages.	true/false