WebSphere Portal

 

Notes and Domino Version 5.02


The Notes and Domino Version 5.02 portlet allows the user to access Notes databases using a Web browser. The Web Sphere Portal administrator can configure the Notes and Domino portlet to provide access to specific types of Notes databases as follows:

For information about working with the Notes and Domino portlet, see the Portlet Help that is available from the portlet title bar.

 

What's new

The individual Lotus Notes portlets available in WebSphere Portal 4.2 are consolidated into this single portlet for 5.0 and 5.02. As portal administrator, you can configure instances of this 5.02 portlet to behave as the 4.2 portlets did by using the portletType parameter. For more information, see Configuration parameters.

In addition, for WebSphere Portal 5.02, this portlet has three new parameters: UseiNotesTemplate, PeopleColumn, and DocumentLaunchColumn.

 

Use the Notes and Domino portlet

The Notes and Domino portlet displays information stored in a Notes database on a Domino server that is set up to work with WebSphere Portal.

The Notes and Domino portlet works with Notes mail databases that have the Domino Web Access (iNotes) design.

 

Portlet security

By default, the Notes and Domino portlet supports single sign-on (SSO), with an LTPA token, giving the user access to both the Domino server that has been set up for use with Lotus Collaborative Components, and the Notes database that is the source for data displayed in the portlet, based on the identity (name and password) the user types to log in to WebSphere Portal.

As portal administrator, you can set up the WebSphere Portal Credential Vault to allow portal users to log in to an instance of the Notes and Domino portlet using an alternate name and password. Credential Vault must be enabled in portal administration to work with this portlet, and configure the VAULT_SLOT parameter for the portlet. When you have configured the parameter, the name and password a user types into the Switch Password field in edit mode authenticates the user for access to one or more source Notes databases for the portlet.

You can create one slot in the Credential Vault to be used for every instance of the Notes and Domino portlet, or you can create separate slots for different instances of the portlet with different values for the PortletType parameter. You can also create a shared vault slot that stores a common credential for all portal users or specific groups of users to use when logging in to any Notes and Domino portlet.

For more information on the Credential Vault and instructions on how to create slots in it, see Authentication. For more information on the VAULT_SLOT parameter in this portlet, see Configuration parameters.

 

Test assumptions

The Notes and Domino portlet has been tested on and is compatible with all supported WebSphere Portal platforms, as listed in Supported hardware and software .

 

Set up the Notes and Domino portlet

Before you install Notes and Domino, make sure your WebSphere Portal environment meets the following client and server requirements.

Client requirements

This portlet supports browsers and devices capable of rendering HTML markup. The following table provides detailed information.

Minimum requirements for HTML
Markup level

  • HTML 4.01 Transitional

Java applet

  • None

JavaScript

  • 1.30

<iframe>

  • Yes

Style sheets

  • Portal styles only

Software

This portlet has been tested on the following browsers:

  • Internet Explorer Version 5.5 with Service Pack 2, 6.0 with Service Pack 1.
  • Netscape Navigator Version 6.2, 7.0x, 7.1
  • Mozilla 1.4

Accessibility

Yes

Server requirements

The Notes and Domino portlet requires WebSphere Portal Version 5.0 or 5.02.

The Notes and Domino portlet requires access to a Domino server with HTTP and Java support enabled.

The Notes and Domino portlet works on the following versions of Domino:

Deployment/Installation

See the WebSphere Portal Help and Information Center for more information about installing portlets.

 

Configuration parameters

The following configuration parameters are available in this portlet.

Parameter Value
NotesServerWhen the Notes and Domino PortletType parameter is set to NOTESVIEW, NOTESDISCUSSION, or NOTESTEAMROOM, you can specify the fully qualified Internet (HTTP) host name of the Domino server that hosts the Notes database that is the information source for the portlet.

Example: yourdominoserver.yourdomain.com

NotesDatabaseWhen the Notes and Domino PortletType parameter is set to NOTESVIEW, NOTESDISCUSSION, or NOTESTEAMROOM, you can specify the file name of the Notes database that is the information source of the portlet.

Examples:

mail/notesid.nsf (for a Notes Mail database)

mail/jdoe.nsf

notesdatabasename.nsf (for any other type of Notes database)

sales/salesdiscussion.nsf

VAULT_SLOTSpecify the name of the slot in the WebSphere Portal Credential Vault that stores credentials for authenticating users of one or more Notes and Domino portlets.

Default: lotus.notes.portlets

The default value is the slot for all Notes and Domino portlets. You can define separate slots for different instances of the Notes and Domino portlet by changing this parameter in each instance copy you create.

Example: lotus.notes.portlets.notesDiscussionPortlet

The value for this parameter is case-sensitive and must match the name of the Credential Vault slot that was created in the Portal Administration - Security task.

PortletTypeThe PortletType parameter determines the type of Notes database source that will be displayed in this instance of the Notes and Domino portlet.

The following examples are fixed values that determine the type of Notes database source that will be displayed in this instance of the Notes and Domino portlet. Enter one of them exactly.

Example: NOTESVIEW (default). Specifying this value configures the portlet with one view, if you as portal administrator also pre-configure values for the NotesServer, NotesDatabase and NotesView parameters. Otherwise, the portlet requests the user to specify a data source in edit mode. Users can add more views in edit mode.

Example: NOTESMAIL. Specifying this value configures the portlet with the following views: All Documents, Inbox, Sent, Drafts, Calendar, To Do, Meetings. With this value, the values for the NotesServer, NotesDatabase and NotesView parameters are ignored, and the portlet looks up the Domino server and Notes mail database specified in the Domino Directory's Person document for the authenticated user in the portal. Users can add more views in edit mode; if so, a View menu appears in view mode.

Example: MYINBOX. Specifying this value configures the portlet with the default view of Inbox. With this value, the values for the NotesServer, NotesDatabase and NotesView parameters are ignored, and the portlet looks up the Domino server and Notes mail database specified in the Domino Directory's Person document for the authenticated user in the portal,. Users can switch to the All Documents view in edit mode, but cannot add more views.

Example: MYCALENDAR. Specifying this value configures the portlet with the default view of Calendar. With this value, the values for the NotesServer, NotesDatabase and NotesView parameters are ignored, and the portlet looks up the Domino server and Notes mail database specified in the Domino Directory's Person document for the authenticated user in the portal. Users cannot add more views.

Example: MYTODO. Specifying this value configures the portlet with the default view of To Do. With this value, the values for the NotesServer, NotesDatabase and NotesView parameters are ignored, and the portlet looks up the Domino server and Notes mail database specified in the Domino Directory's Person document for the authenticated user in the portal. Users cannot add more views.

Example: NOTESDISCUSSION. Specifying this value creates no views and, unless you as portal administrator also pre-configure values for the NotesServer, NotesDatabase and NotesView parameters, requests the user to specify a data source in edit mode. Users can add more views, selecting from a list of views available in the Notes Discussion database design; if they add any views, a View menu appears in view mode in the portlet.

Example: NOTESTEAMROOM. Specifying this value creates no views and, unless you as portal administrator also pre-configure values for the NotesServer, NotesDatabase and NotesView parameters, requests the user to specify a data source in edit mode. Users can add more views, selecting from a list of views available in the Notes Teamroom database design; if they add any views, a View menu appears in view mode in the portlet.

NotesViewWhen the PortletType parameter is set to NOTESVIEW, NOTESDISCUSSION, or NOTESTEAMROOM, you can edit the following default values for this parameter to change the view of the Notes database that displays when users view the portlet.

NOTESVIEW: ($All)

NOTESDISCUSSION: ($All)

NOTESTEAMROOM: ($All)

UseiNotesTemplateThis parameter allows documents to launch with the Domino Web Access (iNotes) URL and user interface. Specify a value for this parameter only when the PortletType parameter is set to either NOTESMAIL, MYINBOX, MYCALENDAR, or MYTODO, and users of the portlet have Notes mail databases that use a Domino Web Access (iNotes) design.

Example: True
PeopleColumnSpecify a column number for this parameter only when the PortletType parameter is set to either MYINBOX, MYCALENDAR, or MYTODO. The portlet's default column for people awareness will then use the column whose number is specified in this parameter.

Example: 1
DocumentLaunchColumnSpecify a column number for this parameter only when the PortletType parameter is set to either MYINBOX, MYCALENDAR, or MYTODO. The portlet's default column for launching documents will then use the column whose number is specified in this parameter.

Example: 1


Related information