Connector for IBM Lotus Notes - Create a Connection

Before you can create a connection in the "Integration" module, you must include the NCSO.jar library file. You can find instructions on how to do this here.

Then go to the "Integration" module.

In the left-hand pane, you'll find the "Consume Data" entry and, below it, the connector for IBM Lotus Notes. When the connector is selected, you can create a new connection via the main menu ("Data Source / New Data Source") or the corresponding context menu.

Connection Parameters

Connection Name

You can choose any name you like for the connection. It appears as a database connection when you integrate the IBM Lotus Notes connection into an application via a third-party data group.

Server

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

Port

Port for the DIIOP service on the Domino server. The port specified here must be open and accessible from the Intrexx server (default port: 63148). If necessary, you may need to configure firewall rules.

External Login

Here, you can select an external login stored in the "Users" module to be used for accessing the database. The "External Logins" section in User Management serves as a central location where the login credentials used to log in to other systems are stored. If you select the "No external login" option, the user account specified below will be used for all sessions.

User

Enter a username here to log in to the Domino server. This user account is required for selecting the database and when creating external data groups.
See also "Which user data is used for which login scenario?"

Password

The user's Domino web/Internet password.

Connection Timeout

This value determines after how many milliseconds Intrexx should stop processing records from the Domino server.

Setting the value to -1 disables the timeout. Setting a timeout can be useful for testing purposes. When you display data in a table in a production system, it should be filtered so that it can be displayed within a reasonable amount of time. When dealing with large amounts of data, it may be useful to copy them into an Intrexx application using a process.

Database Name

The path to the currently selected database on the Domino server is entered here. Example: John Doe's mail file mail/jdoe.nsf

Search

Opens a dialog box where you can select the desired Lotus database.

Lotus Notes Databases

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

For the database search to work, the following option must be enabled: "allow HTTP clients to browse Domino databases." This option is relevant only for searching the database. The connector itself is fully functional even without this option being enabled. If you know the name of the database, you can enter it directly without having to go through the "Search" option.

Email Database

This setting accesses the mail database of the logged-in user.

Test Connection

Clicking this button checks whether Intrexx can successfully establish a connection using the specified credentials (including the external login, if applicable).

Please note that any changes made to a connection that has already been saved will not take effect until the portal service is restarted. When using an IBM Lotus Notes data source, not all Intrexx features are available. For example, processes cannot access the files (embedded objects) of an IBM Lotus Notes data source. The search function in applications is also not available when using an IBM Lotus Notes external data group.

Which user data is used for each login scenario?

In the following, the user who is logged in here using a username and password is referred to as a technical user. For the various login scenarios, the order in which the login credentials are used is specified.

Login when searching for the database name

  1. The "technical user" is used. If the login is unsuccessful, an error message will be displayed.

  2. If no technical user is specified, the anonymous user is used for login.

Test Connection

  1. The external login is being used. If the login is unsuccessful, an error message will be displayed.

  2. If no external login is specified, the technical user is used. If the login is unsuccessful, an error message will be displayed.

  3. If no technical user is specified, the anonymous user is used for login.

Select Applications, External Data Groups, and Fields

  1. The "technical user" is used. If the login is unsuccessful, an error message will be displayed.

  2. If no technical user is specified, the anonymous user is used for login.

Online Registration

  1. The external login is being used. If the login is unsuccessful, an error message will be displayed.

  2. If no external login is specified, the technical user is used. If the login is unsuccessful, an error message will be displayed.

  3. If no technical user is specified, the anonymous user is used for login.

More Information

General Information / Installation

Integrating Data into Applications