Click here to Skip to main content
Click here to Skip to main content

Lotus Notes Integration with Microsoft .NET Platform (C#)

, 23 Apr 2007 CPOL
Rate this:
Please Sign up or sign in to vote.
This article explains how to use .NET and Lotus Notes Interop to integrate Lotus Notes capabilites into applications
Sample Image - maximum width is 600 pixels

Introduction

The article describes with the help of a Windows application how Lotus Notes can be integrated with .NET using Lotus Notes Interop.

Background

The Lotus Notes .NET Interop provides a way of communication between the Microsoft .NET platform and Lotus Notes client and dominos server. It supports access to Lotus Notes documents and views, and allows you to write various applications, for example, Web form, Windows form, and console applications within Microsoft Visual Studio .NET. You can use all Common Language Runtime (CLR) programming languages such as Visual Basic .NET, C#, or Managed C++.

At runtime, the Lotus Notes interop fetches the data as requested using the Interop classes, i.e. NotesViewEntryCollection, NotesViewEntry and NotesDocument. These classes for Lotus Notes clients provides .NET developers with a familiar way to use Lotus Notes functionality. Using the code, developers can access Lotus Notes documents and can integrate Lotus Notes capabilities to any external applications.

This article assumes that you have basic understanding of Lotus Notes.

Prerequisites

  • Windows 2000 or Windows XP 
  • Microsoft Visual Studio .NET 
  • Lotus Notes client installed or Interop.Domino.dll
  • Basic understanding of Lotus Notes.

Create a C# Application using Lotus Notes Connector

The example demonstrates how to fetch information regarding 'Contacts' from user contacts and central contacts database.

Procedure

  1. Open Microsoft Visual Studio .NET.
  2. Create a new C# Windows application project:
    Choose New --> New Project ?--> Visual C# Projects ?--> Windows Application.
    You can also create a project in any other common programming language.
  3. Add controls to your form

In our sample code, we have added few textboxes for configuration of Lotus Notes client, a Button to Start Searching contacts and a Listbox control to list out the results.

  1. In the Solution Explorer, right-click on your project references. 
  2. Choose Add --> Add Reference.
  3. Select Browse button under .NET --> Select the Interop.Domino.dll. (This DLL can be found in the sample code.)
  4. We are ready to go and integrate Lotus Notes capabilities into our application.
  5. First we need to create a session for communicating with Lotus Notes client and dominos server
  6. //
    //
    Code snippet for establishing a Lotus notes session
    //
    //Lotus Notes Object Creation
    _lotesNotesSession = new Domino.NotesSessionClass();
    //Initializing Lotus Notes Session
    _lotesNotesSession.Initialize( NotesPassword );
    //Creating Lotus Notes DataBase Object
    _localDatabase = _lotesNotesSession.GetDatabase( "", "names.nsf", false );
    //creating Lotus Notes Contact View
    _contactsView = _localDatabase.GetView( "Contacts" );
    if( FetchServerData )
    { _lotusNotesServerSession = new Domino.NotesSessionClass();
      _lotusNotesServerSession.Initialize( NotesPassword );
      //Creating Lotus Notes DataBase Object
      _serverDatabase = _lotusNotesServerSession.GetDatabase
    		( DominoServerName, "names.nsf", false );
      //creating Lotus Notes Contact View
      _peopleView = _serverDatabase.GetView( "$People" ); }
    
    }//end if(FetchServerData )  

    (Please take note here that while establishing a session, we only provide userpassword and servername, we don't provide username as the last user login into Lotus client is always taken as the userId.)

  7. Now after establishing a session, we need to iterate through various views to fetch the desired data:
  8. //
    //
    //Code snippet for iterating through the views and fetching data
    //
        NotesViewEntryCollection  notesViewCollection =LotusNotesView.AllEntries;
        for( int rowCount = 1; rowCount <= notesViewCollection.Count; rowCount++ )
        {
            //Get the nth entry of the selected view according to the iteration.
            NotesViewEntry viewEntry = notesViewCollection.GetNthEntry( rowCount );
            //Get the first document of particular entry.
            NotesDocument document =  viewEntry.Document;
    
            object documentItems = document.Items;
            Array itemArray1 = (System.Array)documentItems;
    
            for( int itemCount=0 ; itemCount< itemArray1.Length; itemCount++ )
            {
                NotesItem notesItem = 
    			(Domino.NotesItem)itemArray1.GetValue( itemCount );
    
                //compare field value with specific value entered by user
                if( notesItem.Text !=null )
                {
                    if( (notesItem.Text.ToUpper()).StartsWith( fieldValue ))
                    {
                        Contact contact = new Contact();
                        for( int icount=0 ; icount< itemArray1.Length; icount++ )
                        {
                            NotesItem searchedNotesItem =
    			(Domino.NotesItem)itemArray1.GetValue( icount );
                            string FieldName = searchedNotesItem.Name.ToString();
                            //For FirstName
                            if( searchedNotesItem.Name == "FirstName" )
                                contact.FirstName= searchedNotesItem.Text;
    
                            //For LastName
                            if( searchedNotesItem.Name == "LastName" )
                                contact.LastName = searchedNotesItem.Text;
                            //For Office Phone Number
                            if( searchedNotesItem.Name == "OfficePhoneNumber" )
                                contact.OfficePhoneNumber = searchedNotesItem.Text;
    
                            if( searchedNotesItem.Name  == "InternetAddress" )
                                contact.EmailId = searchedNotesItem.Text;
    
                        }//end for
                        contactsList.Add( contact );
                        break;
                    }//End if
                }
            }
        }

    If you see in the above code snippet NotesViewEntry, NotesDocument, NotesItem classes are used to create the objects for Lotus Notes driver data access. So the code snippet and the sample application demonstrates how easily one can integrate Lotus Notes accessing capabilities into an application.

How to Pop Open a Contact in Lotus Notes

//
//
//Code snippet for popping open a document/contact in lotus notes client
//
//ContactId is the Main thing :
//this is the universaldocumentID which uniquely identifies this
//if the contacts is on the server

if( IsServerData )
{
	notesUrl="Notes://"+LotusNotesServer+"/names.nsf/0/"+ContactId;
}
else
{    //local data
	notesUrl="Notes:///names.nsf/0/"+ContactId;
}

	string lotusNotesPath = ReadRegistry();
	if( lotusNotesPath!="" )
	{
		lotusNotesPath = lotusNotesPath+"notes";
		System.Diagnostics.Process process =
		new System.Diagnostics.Process();
		System.Diagnostics.Process.Start( lotusNotesPath,notesUrl );
		System.Threading.Thread.Sleep( 500 );
} 

History

  • 23rd April, 2007: This is the first draft of the application.
    I will try and update this to further integrate with other Lotus Notes document types.

About Aditya Gupta

Sample Image - maximum width is 600 pixels

I am currently working in an outsourced software product development company, PROTEANS SOFTWARE SOLUTIONS LTD.(www.proteans.com) as a Technical Leader. I have around 6 years of experience in the software industry, mainly telecom, computer telephony integration. I have experience in VC++, MFC and in Microsoft .NET technologies(C#).

About Proteans Software Solutions

Proteans is an outsourcing company focusing on software product development and business application development on Microsoft Technology Platform. Proteans partners with Independent Software Vendors (ISVs), System Integrators and IT teams of businesses to develop software products. Our technology focus and significant experience in software product development - designing, building, and releasing world-class, robust and scalable software products help us to reduce time-to-market, cut costs, reduce business risk and improve overall business results for our customers. Proteans expertises in development using Microsoft .NET technologies.

Acknowledgements

Special thanks to Pankaj Pahuja (pankaj_proteans@hotmail.com) for his inputs and guidance on Lotus Notes client and how to get going with Lotus Interop.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Aditya P Gupta
Web Developer
India India
No Biography provided

Comments and Discussions

 
QuestionPERFECT! [modified] PinmemberMember 1054474014-May-14 1:41 
QuestionUsing Interop.Domino.dll without any lotus notes client. PinmemberMember 986469922-Jan-14 1:03 
GeneralMy vote of 3 PinmemberMember 1034384417-Oct-13 23:24 
QuestionDownload Specific Attachments from Lotus Notes [modified] PinmemberYuvrajDhamdhere3-Jun-13 3:15 
QuestionHow to read mails from NotesDatabase object Pinmemberdarshanjbhatt22-Apr-13 3:01 
AnswerRe: How to read mails from NotesDatabase object Pinmembererikfranz28-Jun-14 9:52 
QuestionUsing Interop.Domino.dll without Lotus client installed Pinmemberantipirat8-Oct-12 2:17 
AnswerRe: Using Interop.Domino.dll without Lotus client installed Pinmemberdarshanjbhatt8-May-13 0:46 
GeneralRe: Using Interop.Domino.dll without Lotus client installed Pinmembermreyeros23-Aug-13 9:50 
GeneralRe: Using Interop.Domino.dll without Lotus client installed PinmemberMember 1099293020-Nov-14 3:00 
GeneralRe: Using Interop.Domino.dll without Lotus client installed PinmemberMember 986469922-Jan-14 1:10 
QuestionView Name for To Do List PinmemberMember 94680023-Oct-12 20:24 
QuestionSMS from Lotus Notes PinmemberWilsonLast14-May-12 20:56 
QuestionHow to test Lotus Notes Integration with Microsoft .NET Platform (C#)? Pinmembersawasthi28-Mar-12 23:43 
QuestionHow can i read Lotus Notes Database Items with .Net (C#) without installing Lotus Notes on my System ? PinmemberTRON_VS_NEO19-Dec-11 12:43 
QuestionPerformance Issue : Please Help PinmemberBryan Ruddy20-Oct-11 6:23 
QuestionAccessing Groups from Lotus Notes using Domino.dll and C#. PinmemberPreeeti0824-Oct-09 1:28 
GeneralTrouble wih version of Lotus Notes Pinmemberphenix_28-Aug-09 2:51 
GeneralGetting COM Error [modified] PinmemberSuleymanNalci27-Aug-09 5:38 
GeneralLotusnotes documents migration issue Pinmembersamtech599-Jun-09 11:18 
Questionreschedule a meeting Pinmembermoali7216-Mar-09 21:58 
QuestionLotus Notes Pinmembershowri raju3-Mar-09 2:53 
GeneralLotus notes integration Pinmemberbeetools4-Feb-09 0:52 
GeneralThanks for the example code PinmemberTed Takacs23-Dec-08 4:46 
QuestionAsp.net And Lotus notes ( Calender ) Pinmembermurad198513-Dec-08 2:24 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.141223.1 | Last Updated 23 Apr 2007
Article Copyright 2007 by Aditya P Gupta
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid