Connector for IBM Lotus Notes - Create connection

Before you can create a connection in the "Integration" module, the NCSO.jar library file must be integrated. You can find instructions here.

Then switch to the "Integration" module.

On the left-hand side you will find the entry "Consume data" and below it the connector for IBM Lotus Notes. If the connector is selected, a new connection can be created via the main menu "Data source / New data source" or the corresponding context menu.

Connection parameters

Connection name

The name of the connection is freely selectable. It is displayed as a database connection if you integrate the IBM Lotus Notes connection into an application via an external data group.

Server

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

Port

Port of the DIIOP service on the Domino server. The port specified here must be released and accessible from the Intrexx server (default port: 63148.) You may need to set up firewall activations.

External login

Here you can select an external login stored in the "User" module that is to be used to access the database. In the "External logins" area, the logins that can be used to log in to other systems are stored centrally in the user administration. If you select the "No external login" option, the user account entered below will be used for all calls.

User

Enter the user name here for logging in to the Domino Server. This user account is required for the selection of the database and for the creation of external data groups.
See also"Which user data is used for which login case?".

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 display the data in a table in a production system, it should be filtered so that it can be displayed in a reasonable amount of time. For large amounts of data, it can be useful to copy these into an Intrexx application via a process.

Database name

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

Search

Opens a dialog in which the desired Lotus database can be selected.

Lotus Notes databases

Select the desired database here and then click "OK".

For the search for databases to work, 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, you can also enter it directly without having to use "Search".

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 check whether Intrexx can successfully establish a connection with the specified data (if applicable, the external login).

Please note that subsequent changes to an already saved connection will only take effect after the portal service has been restarted. When using an IBM Lotus Notes data source, not all Intrexx functions are available. For example, the files (embedded objects) of an IBM Lotus Notes data source cannot be accessed in processes. The search function in applications is also not available with an IBM Lotus Notes external data group.

Which user data is required for which use case?

In the following, the user who is entered here in the dialog with user name and password is referred to as the technical user, and the order in which the login data is used is specified for the various login scenarios.

Login when searching for the database name

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

  2. If no technical user is entered, the anonymous user is used to log in.

Test connection

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

  2. If no external login is stored, the technical user is used. If the login is not successful, an error is displayed.

  3. If no technical user is entered, the anonymous user is used to log in.

Select applications and external data groups and fields

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

  2. If no technical user is entered, the anonymous user is used to log in.

Login in the web

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

  2. If no external login is stored, the technical user is used. If the login is not successful, an error is displayed.

  3. If no technical user is entered, the anonymous user is used to log in.

More information

General / Installation

Integrate data into applications