Consume data - Connector for IBM Lotus Notes
Integration module
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.
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:
- Close the Portal Manager.
- Stop all Intrexx services.
- Copy the file "NCSO.jar" to the
installation directory
/lib.
- Restart all Intrexx services.
- 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:
- Go to the "Integration" module.
- Click on "Connector for IBM Lotus Notes" under "Consume data".
- 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.
|
- Enter the required parameters.
- 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
-
The technical user is used.
If the login is not successful, an error message is shown.
-
If a technical user has not been specified, the anonymous user
is used for the login.
Test connection
-
The external login is used.
If the login is not successful, an error message is shown.
-
If an external login has not been specified, the technical user is used.
If the login is not successful, an error message is shown.
-
If a technical user has not been specified, the anonymous user
is used for the login.
Select applications and external data groups and fields
-
The technical user is used.
If the login is not successful, an error message is shown.
-
If a technical user has not been specified, the anonymous user
is used for the login.
Login in the web
-
The external login is used.
If the login is not successful, an error message is shown.
-
If an external login has not been specified, the technical user is used.
If the login is not successful, an error message is shown.
-
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