Notes and Domino V5.1

Notes and Domino V5.1

+
Search Tips | Advanced Search

Overview

The Notes and Domino V5.1 portlet can access and render the following types of Notes databases...

Notes Mail Any view (for example, Inbox, Calendar, or To Do) of a Notes Mail database to which a portal user has access.
Notes View Any view of any Notes database to which a portal user has access. Users can add multiple views to a View menu.
Notes Teamroom Any view of a Notes Teamroom to which a portal user has access.
Notes Discussion Any view of a Notes Discussion to which a portal user has access.
My Notes Mail Displays a portal user's own Notes Inbox, using the identity with which the user logs into WebSphere Portal.
My Notes Calendar Displays a portal user's own Notes Calendar, using the identity with which the user logs into WebSphere Portal.
My Notes To Do Displays a portal user's own Notes To Do (task) list, using the identity with which the user logs into WebSphere Portal.

An instance of this portlet appears in the Collaboration Center on the My Workplace --> Domino Databases page as "Lotus Notes View."
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 and works with Notes mail databases that have the Domino Web Access (iNotes) design.

User Credentials

Credential Vault can hold either a shared user name and password (for applications that can use the same credentials for all users) or private credentials for each user. By default, when the user first accesses the portal page with a portlet that accesses Domino mail and/or calendar, the user is prompted for their user name and password. For all subsequent visits, the portal simply passes the user name and password on to Domino. If the user changes his/her password, the portal will prompt the user to re-enter the credentials.
If you enable single sign-on between Domino and WebSphere the portal will automatically authenticate with Domino, providing single sign-on. Mail is displayed immediately when users go to a page with a mail portlet.
There are two user interface options:

Domino Web Access (DWA) Used to be known as iNotes portlet. Testing has shown that the lightweight DWA interface is up to 30% faster than the default DWA interface.
Common PIM Portlets (CPP) CPP portlets provide a generic interface to all different types of mail systems. The UI is not as rich as the DWA portlet.

PortletType

The PortletType parameter controls the appearance and function of the Notes and Domino portlet.

PortletType= Portlet functionality
NOTESVIEW
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.

NOTESMAIL
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.

MYINBOX
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.

MYCALENDAR
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.

MYTODO
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.

NOTESDISCUSSION
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.

NOTESTEAMROOM
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.

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.

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

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

Set up awareness and chat

You can enable awareness and chat features in a view of a Lotus Notes database accessed by the Domino Databases portlet by modifying the properties of the portlet instance.

In the title bar, click the Edit (pencil) icon.
Under Available Views, click Add.
Under View Title, enter a title, for example "Operations Discussion - By Author."
Under Server, specify the server name where the mail file is located (for example, acme.sales.com). Select the check box next to the Server section.
Under Database filename, select the mail file path, for example, "mail," and then select the name of the source Lotus Notes database, for example "acme_sales_discussion.nsf." Select the checkbook next to the Database filename section.
Under View, select the view name ("By Author") that corresponds to the view you want to show (the view represented by the View Title entered above).
Select Next.
Select a column that contains names from the Column for showing people awareness list.
Click Done, then Save.

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 V6.0 with the following Java software:

Sun JVM 1.4.1
IBM JDK 1.4.1 or IBM JDK/JRE 1.4.1
Microsoft JVM 1.1.8

Mozilla 1.41 on Linux with the following Java software:

Sun JVM 1.4.1

Accessibility
Yes

Server requirements

The Notes and Domino portlet requires access to a Domino mail and appserver with HTTP and Java support enabled. The Domino server hosts the Notes information source.
The portlet is compatible with the following versions of Domino:

6.5.1, 6.5.2, and 6.5.3
5.0.12

If you want users of the portlet to be able to select the source Notes database file name from a drop-down list, the Domino server must have DIIOP support enabled, and on the Server document Internet Protocols - HTTP tab, the option "Allow HTTP clients to browse databases" must be set to Yes.
If you do not choose to enable DIIOP support, you can specify a default database filename in the portlet parameter NotesDatabase, and users of the portlet can type over that filename if necessary to specify the information source.

Deployment/Installation

This portlet is installed automatically as part of WebSphere Portal installation.
This portlet is not supported as a remote WSRP service.

Configuration parameters

The following configuration parameters are available in this portlet.

Parameter Value
NotesServer
When 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.setgetweb.com

NotesDatabase
When 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_SLOT
Specify 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.

PortletType
The 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. For details on the results of configuration with these parameters, see Using the Notes and Domino portlet.

Example: NOTESVIEW (default)
Example: NOTESMAIL
Example: MYINBOX
Example: MYCALENDAR
Example: MYTODO
Example: NOTESDISCUSSION
Example: NOTESTEAMROOM

NotesView
When 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)

UseiNotesTemplate
This 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

PeopleColumn
Specify 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

DocumentLaunchColumn
Specify 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

See also

Collaborative portlets
Working with the Collaboration Center
Common Mail
Common Calendar
Set up the Collaboration Center
Configure IBM Lotus Domino Enterprise Server mail and appservers and WebSphere Portal to work together

Home |

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.

Notes Mail	Any view (for example, Inbox, Calendar, or To Do) of a Notes Mail database to which a portal user has access.
Notes View	Any view of any Notes database to which a portal user has access. Users can add multiple views to a View menu.
Notes Teamroom	Any view of a Notes Teamroom to which a portal user has access.
Notes Discussion	Any view of a Notes Discussion to which a portal user has access.
My Notes Mail	Displays a portal user's own Notes Inbox, using the identity with which the user logs into WebSphere Portal.
My Notes Calendar	Displays a portal user's own Notes Calendar, using the identity with which the user logs into WebSphere Portal.
My Notes To Do	Displays a portal user's own Notes To Do (task) list, using the identity with which the user logs into WebSphere Portal.

Domino Web Access (DWA)	Used to be known as iNotes portlet. Testing has shown that the lightweight DWA interface is up to 30% faster than the default DWA interface.
Common PIM Portlets (CPP)	CPP portlets provide a generic interface to all different types of mail systems. The UI is not as rich as the DWA portlet.

PortletType=	Portlet functionality
NOTESVIEW	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.
NOTESMAIL	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.
MYINBOX	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.
MYCALENDAR	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.
MYTODO	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.
NOTESDISCUSSION	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.
NOTESTEAMROOM	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.

>>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 V6.0 with the following Java software: Sun JVM 1.4.1 IBM JDK 1.4.1 or IBM JDK/JRE 1.4.1 Microsoft JVM 1.1.8 Mozilla 1.41 on Linux with the following Java software: Sun JVM 1.4.1
Accessibility	Yes

Parameter	Value
NotesServer	When 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.setgetweb.com
NotesDatabase	When 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_SLOT	Specify 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.
PortletType	The 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. For details on the results of configuration with these parameters, see Using the Notes and Domino portlet. Example: NOTESVIEW (default) Example: NOTESMAIL Example: MYINBOX Example: MYCALENDAR Example: MYTODO Example: NOTESDISCUSSION Example: NOTESTEAMROOM
NotesView	When 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)
UseiNotesTemplate	This 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
PeopleColumn	Specify 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
DocumentLaunchColumn	Specify 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