Talend tNotesInput Connector Instructions:
Please Note: If you don’t really “know” Lotus Notes, then these components probably won’t help you much. Notes doesn’t work like traditional SQL databases (it is more of a NoSQL type database). As such, you may need help. Support, maintenance, and training packages are available for our components. Please contact us for additional information: Traction Consulting Group – Contact Information
Download The Components:
- Download them from Talend Exchange
Initial Setup:
- Install our components in a new directory under your Talend directory.
- In Windows -> Preferences -> Talend -> Components, change the User Component path to your extracted path.
- For tNotesInput to work, you need to load the Notes.jar library. This file is available from either the Client or the Server. So, your first component in your job should be tLibraryLoad, which will declare Notes.jar
Configuring tNotesInput:
- DIIOP – Allows you to bypass the local Client and instead execute remote instructions to the server. Minimizes the footprint on the client, but slows down processing. This option is necessary if you are working in 64bit client environments.
- Set the iNotes user id and password if you use DIIOP. Also, specify your server address for the DIIOP port.
- Use the local client Password (current .ID file) if you do not use DIIOP
- Domino Server & File/Path Name – Server can be local (leave as “”), or enter the server name here. File/Path should use forward slashes (like in the example)
- ViewName – The name of the view you will “read”. Alternatively, you can select the @Formula checkbox. When checked, you can specify a Lotus Notes Select formula instead of a view (return a NotesDocumentCollection).
- ReverseIndex – Read from the bottom of the View (or Collection) instead of the top.
- # Docs To Return – Leave ALL if you want all docs in the view. Otherwise, specify the limit (integer).
- Schema: The schema needs to be declared (since every notes entity can have unlimited fields). To do so, please review the following picture. IT shows an example schema for an Email message in Notes. Note how you can override Field names (Db Column) with an @Function formula placed in the Comment box.
Additional Support:
- You can purchase a support, maintenance, and training package for your company. This is the best way to fully utilize the components, and ensure your production environment is supported. Please contact us for additional information: Traction CG
Traction Consulting Group

Frank Weeber 8:07 am on February 21, 2012 Permalink |
Hi Joe,
I am trying to connect to a local notes database for test purposes.
The job works fine as described at your website, except it doesnot return any rows.
I am trying to read the calendar and display the values in subject and date and time.
Could you point me in the right direction if I want to read data from a view from the calendar. What should the values be in the input parameters of the tNotesInput component?
I am not a Lotus Notes expert so i thought i start with reading the view before using the @formula option.
Thanks in advance.
Regards,
Frank
Joe Wichowski 8:23 am on February 21, 2012 Permalink |
We would probably need some screen prints. If it comes back with “zero rows”, it means it is connecting to the view (or the Search formula), but the view/formula is returning zero records.
Try changing to a Search @Formula, and use:
Select @ALL;
That should return everything in the database. If it still connects (but doesn’t find anything), then Local Security protection is probably on the database, and it doesn’t want you to open it “locally” – you will need to open it on the server.
Hope that helps.
/joe
Joe Wichowski 3:59 pm on February 21, 2012 Permalink |
You bet. I’ll hit you up for a beer next time I am in Amsterdam…
/joe
Frank Weeber 10:40 am on February 21, 2012 Permalink |
Joe,
Thanks for your quick reply. It was the local security. I have only the client installed and no server.
This in preparation for a possible assignment.
So I reinstalled the client and made sure I could open mail.nsf locally. Now it works.
Thanks for providing the components to the community.
Regards,
Frank
Jérôme Gassies 9:29 am on March 16, 2012 Permalink |
Hi,
any plan for 5.0.2 support ?
Trying it add component but enable to find it.
Regards
Jerome
Joe Wichowski 3:09 pm on March 16, 2012 Permalink |
Jerome,
All our connectors work with 5.x. They should be able to be added fine to your 5.02.
I am unsure what you mean by “trying to add component”. Did you install it in 5.02 list of connectors? Are you trying to download it? A little more info would be helpful.
/joe
Gene E 8:42 pm on March 21, 2012 Permalink |
Hi Joe, I’m getting the following error when running the job.
Exception in thread “main” java.lang.Error: java.lang.Error: java.lang.UnsatisfiedLinkError: no nlsxbe in java.library.path
I have tried adding the ncso.jar in my library path of the LibraryLoad as well as build path java preferences as well as modifying path system environment variables. Any ideas?
Thanks for any help, Gene
Joe Wichowski 9:50 am on March 23, 2012 Permalink |
It reads to me like your Notes program directory is not in the PATH statement. That, or it is not finding a good reference to your Notes.jar file.
The message is essentially saying “I’m trying to access the nlsxbe.dll file, but I cannot find it.” So it is definately a path issue. Hope that helps.
/joe
Bernard Monteil 1:55 pm on April 5, 2012 Permalink |
Hi,
I am new to using Talend and I have tre dto implement yout tNotesInput connector.
I have the following errors “Module Notes.jar required” although I have specified the Notes.jar in the tLibraryLoad component.
Thanks in advance
Regards,
Bernard
Joe Wichowski 2:49 pm on April 5, 2012 Permalink |
Unfortunately, that message means it can’t find it. Not sure why – tLibraryLoad is the way to go. Make sure you have the Lotus Notes client installed on the same box as Talend, and that you have the PATH statement updated to reflect the Lotus Notes program directly.
/joe