Consume data - Connector for IBM Lotus Notes

Integration module

General information

Integrating the library file NCSO.jar

When connecting the Lotus Notes interface and creating a data connection via DIIOP (Domino Internet Inter-ORB Protocol), it is possible to integrate data (such as addresses, project data, etc.) from a Domino server into a portal. To do so, the library file "NCSO.jar" must be connected. This file is contained in the delivered version of Lotus Notes. In order to correctly register the library, please carry out the following steps:
  1. Close the Portal Manager.
  2. Stop all Intrexx services.
  3. Copy the file "NCSO.jar" to the installation directory /lib.
  4. Restart all Intrexx services.
  5. Open the Portal Manager and switch to the Integration module.

Step-by-step guide


To add a Lotus Notes data source in the Intrexx Portal Manager, please proceed as follows:
  1. Go to the "Integration" module.
  2. Click on "Connector for IBM Lotus Notes" under "Consume data".
  3. Right-click on the item and select "New data source" from the context menu.
    This will open the "Connection parameters" dialog.



    Name Description
    Connection name Provide the connection with a name. 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 stored in the Users module that should be used for accessing the database. If you do not select an external login, then the user account defined 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 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: Email 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).

    Please note that changes made to an already saved connection are only effective 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.
  4. Enter the required parameters.
  5. Click on "OK".
    You have added a Lotus Notes data source.

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

Integrate Lotus Notes into an application
Connector for IBM Lotus Notes - Connection parameters