COMPOSITE APPLICATIONS - DESIGN AND MANAGEMENT


Using Portlet configuration parameters to control the Launcher user interface
Instances of composite applications can be serialized to an XML format, referred to as a composite application definition.

Lotus Notes can interpret a specific set of preferences that are set in a portlet entity instance. It uses preference settings when it creates the perspective for a particular portlet. These preferences are listed and described in the following table:

Note The portlet can contain any of the parameters identified below. The table shows the portlet preference name you should use when configuring the portlet. You can use the base Portal portlet configuration user interface.
PreferenceDescriptionTypeReq'd
com.ibm.rcp.viewIdThis specifies the unique ID of the Eclipse-based view to which this portlet is mapped.

The default is
com.ibm.rcp.portletviewer.viewer

Stringyes
com.ibm.rcp.folderThis specifies the unique ID of the Eclipse tabbed folder to which this view should be added when it is added to the perspective layout.

There is no default.

Stringno
com.ibm.rcp.showTitleThis specifies the Boolean value determining if the view should have a title bar when it is rendered.

The default is true.

booleanno
com.ibm.rcp.ratioThis specifies the portion of the layout area this component should occupy based on the component it is attached to within the layout. This is the Eclipse- based sizing of perspective layouts. If this is not specified, the default ratio constant supplied by Eclipse is used.

The default is 0.5.

floatno
com.ibm.rcp.visibleThis specifies the Boolean value determining if the view should be visible when the perspective is first opened. If set to false the view is added to the layout as a placeholder. This opens the view in the proper location.

The default is true.

booleanno
com.ibm.rcp.fastViewThis specifies the Boolean value determining if this view should be added to the layout as a fast view. Fast views are added to the client's fast view bar.

The default is false.

booleanno
com.ibm.rcp.standaloneThis specifies the Boolean value determining if this view should be added to the layout as a standalone view.

The default is false.

booleanno
com.ibm.rcp.moveableThis specifies the Boolean value determining if this view should be moveable within the perspective.

The default value is true.

booleanno
The following table contains the Eclipse extension points and page properties mappings that you can specify in Portal to tell the client where the page/perspective can be launched. Pertinent page properties are in bold.
ParameterDescriptionPortal MappingReq'd
idThe unique identifier of the page or label. If the navigation element is a page, this identifier is the identifier of the perspectiveidyes
themeThe unique identifier of the theme specified for this navigation element (if applicable)noneno
com.ibm.rcp.defaultFolderThe id of the default Eclipse folder to be used for this navigation object. This applies only to navigation elements which are pages. When an eclipse view is opened in this perspective dynamically, it will open in this folder.

There is no default.

com.ibm.rcp.defaultFolderno
com.ibm.rcp.activitiesThe list of Eclipse activities to be associated with the page. The value for this attribute should be in the format of a semi-colon delimited list, such as:

activities=com.ibm.myactivity;
com.ibm.mail.activity

There is no default.

com.ibm.rcp.activitiesno
com.ibm.rcp.typeA restricted value indicating what type of navigation element this is. This can be one of two types, TYPE_PERSPECTIVE and TYPE_LABELsameyes
com.ibm.rcp.parentThis is the unique identifier of this navigation elementfs parent element. If none is specified then it is assumed to be a root level navigation element.sameno
com.ibm.rcp.useNavigatorTrue or false value determining if this perspective should use the navigator view handled by the user interface layer. This attribute should only be set on the root label for a portal application.

The default is true.

com.ibm.rcp.useNavigatorno
com.ibm.rcp.autoStartTrue or false value determining if this perspective should be launched automatically when the application is loaded.

The default is false.

com.ibm.rcp.autoStartno
com.ibm.rcp.launcherTrue or false value which determines if this perspective/label should be added to the launcher in the user interface.

The default is false.

com.ibm.rcp.launcherno