Mailing-List: contact docs-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@cocoon.apache.org
Date: Sun, 6 Jun 2004 15:00:03 +0200
Message-Id: <200406061300.i56D03v13989@otsrv1.iic.ugent.be>
From: stevenn@outerthought.org
To: docs@cocoon.apache.org
Subject: [WIKI-UPDATE] LotusDomino Main Sun Jun  6 15:00:03 2004

Page: http://wiki.cocoondev.org/Wiki.jsp?page=LotusDomino , version: 1 on Sat Jun  6 12:23:03 2004 by Litrik

New page created:
+ !! Using data from Lotus Domino
+ 
+ There are several ways to access data stored in Lotus Notes / Domino.
+ 
+ ! ReadViewEntries
+ 
+ ReadViewEntries is a standard Lotus Domino URL command that can be used to retrieve entries of a view in XML format. This has been available since Lotus Domino 5.0.2.
+ 
+ More info can be found in [the official Lotus documentation |http-link-towww-12.lotus.com/ldd/doc/domino_notes/Rnext/help6_designer.nsf/f4b82fbb75e942a6852566ac0037f284/53e0cb0653be6d2685256c54004b8de2?OpenDocument] , in an article at [IBM Developerworks|http-link-towww-10.lotus.com/ldd/today.nsf/lookup/DynamicCategorizedViews] and in an old [IBM Redbook|http-link-topublib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg246207.html?Open].
+ 
+ There are some online samples [here|http-link-towww.projectdx.org/_art17.htm].
+ 
+ Typical usage is as part of a generator in a pipeline.
+ 
+ Example pipeline snippet:
+ {{{
+   <map:match pattern="internal/faqs/*">
+     <map:generate type="file" src="http-link-todomino.company.com/faqdatabase.nsf/faqs-by-topic?readviewentries&amp;RestrictToCategory={1}&amp;Start=1&amp;Count=300"/>
+     <map:transform src="xsl/domino/faq-view2xhtml-snippet.xsl"/>
+     <map:serialize type="xml"/>
+   </map:match>
+ }}}
+ 
+ Some remarks:
+ * ReadViewEntries provides only ''read'' access to data
+ 
+ ! Toolkit for Java/CORBA
+ 
+ This toolkit includes java classes to access data on a Lotus Domino server. Escpecially the NCSO.jar file is important because it allows remote access to the Domino server (and your Cocoon server is probably not running on the same machine as your Domino server).
+ 
+ The toolkit can be downloaded from the [Lotus Toolkits and Drivers site|http-link-towww-10.lotus.com/ldd/toolkits]. The documentation is available [here|http-link-towww-10.lotus.com/ldd/notesua.nsf/ddaf2e7f76d2cfbf8525674b00508d2b/68600015eb4caa97852569d9005a23cd?OpenDocument].
+ 
+ Typical usage is as Java code in your own component, Java code in an XSP, or in flowscript.
+ 
+ Example flow snippet:
+ {{{
+ importPackage(Packages.lotus.domino);
+ 
+ function writelog(userid, message)
+ {
+   var s = null ;
+   var db = null ;
+   var logdoc = null ;
+ 	
+   try
+   {
+     s = Packages.lotus.domino.NotesFactory.createSession("domino.company.com", "userid", "password");
+     db = s.getDatabase(null, "mydatabase.nsf") ;
+ 		
+     logdoc = db.createDocument();
+     logdoc.replaceItemValue("Form", "Log");
+     logdoc.replaceItemValue("logUserid", userid) ;
+     logdoc.replaceItemValue("logAction", message);
+     logdoc.save() ;
+   }
+   catch(e)
+   {	
+   }
+   finally
+   {
+     try
+     {
+       if(logdoc != null)
+       {
+         logdoc.recycle() ;
+       }
+       if(db != null)
+       {
+         db.recycle() ;
+       }
+       if(s != null)
+       {
+         s.recycle() ;
+       }
+     }
+     catch(e)
+     {
+     }
+   }
+ }
+ }}}
+ 
+ Some remarks:
+ * The Java toolkit allows both ''read'' and ''write'' access.
+ * The Java toolkit uses DIIOP (Corba) for remote connections. Performance is not great.
+ * You need to call the recycle() method to clean up memory. There's no decent memory management.
+ * The jar files of this toolkit are also included in recent Lotus Notes clients.
+ 
+ 


Page: http://wiki.cocoondev.org/Wiki.jsp?page=Main , version: 456 on Sat Jun  6 12:50:08 2004 by Litrik

+ * June 6, 2004
+ ** Using data from [Lotus Domino]