Connector for IBM Lotus Notes - Connection parameters

General information

  • Intrexx accesses the Lotus Notes or Domino Server via the Lotus Notes Java API via the Notes protocol DIIOP (Domino Internet Inter-ORB Protocol).

  • The HTTP and DIIOP services on the Domino Server need to be activated.

Name

Description

Connection name

Provide the connection with a name here. This name is free choice.
The connection name entered here is shown when you integrate the Lotus Notes database into an application as an external data group.
More information about this is available in the chapter Integrate external data into applications.

Server

Enter the hostname (Fully Qualified Domain Name) or the IP address of the Domino server.

Port

Enter the port of the DIIOP service on the Domino Server.
The port entered here must be open and available to the Intrexx server (default port: 63148).
You may need to configure your firewall for this.

External login

Here you can select an external login from the "User" module to access the database. In the External login area, the logins that can be used to log in to other systems are stored in a central location in the user administration. User Enter the user name here for logging in to the Domino Server.

User

Enter the user name here for logging in to the Domino Server. This user account is required for selecting the database and for creating the external data group.
For more information, see the chapter Which user data is required for which use case?.

Password

Enter the password (Domino web/Internet password of the user).

Connection timeout

This value determines how many milliseconds Intrexx will wait for a response from the Domino server.
The value -1 will deactivate the timeout.
It makes sense to set a timeout for testing purposes.
If you show data in a view table in a live system, it should be filtered so that it is shown after a reasonable amount of time.
If you have large amounts of data, it can make sense to copy these to an Intrexx application via a process.

Database name

The path to the currently selected database on the Domino Server is shown here. Example: Mail file John Doe mail/jdoe.nsf

Search

Opens a dialog where the desired Lotus database can be selected.

So that the database search works correctly, the following option must be activated: "allow HTTP clients to browse Domino databases"
This option is only relevant for the search for the database. The connector itself is fully functional without this option.
If you know the name of the database, then you can enter it manually.

Mail database

With this setting the database of the user that you entered in the configuration will be accessed.

Test connection

Click on this button to test whether Intrexx can successfully establish a connection using the data specified (or using the external login).

Note Bear in mind that subsequent changes to an already saved connection only take effect after the

portal service has been restarted. When using a Lotus Notes data source, not all Intrexx functions are available. For example, a process cannot access files (embedded objects) of a Lotus Notes data source. The search function of an Intrexx application will also not be available in a Lotus Notes external data group.

Which user data is required for which use case?

In the following, the user who was entered in the "Connection parameters" dialog will be referred to as the technical user.
For the different login scenarios, the order in which the credentials are used is specified.

Login when searching for the database name

  1. The technical user is used. If the login is not successful, an error message is shown.

  2. If a technical user has not been specified, the anonymous user is used for the login.

Test connection

  1. The external login is used. If the login is not successful, an error message is shown.

  2. If an external login has not been specified, the technical user is used. If the login is not successful, an error message is shown.

  3. If a technical user has not been specified, the anonymous user is used for the login.

Select applications and external data groups and fields

  1. The technical user is used. If the login is not successful, an error message is shown.

  2. If a technical user has not been specified, the anonymous user is used for the login.

Login in the web

  1. The external login is used. If the login is not successful, an error message is shown.

  2. If an external login has not been specified, the technical user is used. If the login is not successful, an error message is shown.

  3. If a technical user has not been specified, the anonymous user is used for the login.

More information

Consume data - Connector for IBM Lotus Notes
Integrate Lotus Notes data into applications