3E084BF9d01

CIB306Lotus Notes and Domino 8: What's New in LotusScript and Formula Language Rocky Oliver Template 2.0 Architect Lotus Software/IBM [email protected] Advisor.com Before we begin… Please turn off: Pagers Cellphones Anything else that buzzes, sings, beeps, chirps, barks, etc. Advisor.com CIB306: What’s New in Formulas and LotusScript in ND8 - Page 1 ©2007 ADVISOR MEDIA, Inc. and Speaker. All Rights Reserved. Notes and Domino 6 Programming Bible (Wiley.com Purpose This session is designed to introduce you to the new features found in LotusScript and Formulas in Lotus Notes and Domino 8 It should convince you that LotusScript continues to be an important part of the Domino development environment Hopefully it will also convince you that formulas continue to be an important part of your development toolkit Advisor. technical editor for Lotus ADVISOR Speak at numerous technology conventions.com Advisor. Special Edition: Using Notes/Domino 6 (Que. . April 2003) Contributing author. and various European conferences Lotus Geek (blog): www.Who am I? Began my Notes/Domino life with Lotus .LotusGeek. 1997) Written many articles for Lotus ADVISOR & WebSphere ADVISOR. Inc. re-joined IBM/Lotus Software June 2005 Co-author. 2001) Co-author. All Rights Reserved.Page 2 ©2007 ADVISOR MEDIA. and Speaker.6 (MIS Press.com CIB306: What’s New in Formulas and LotusScript in ND8 . Teach Yourself…LotusScript for Notes/Domino 4. such as Lotusphere. ADVISOR Devcons. Lotus Devcon/IBM DeveloperWorks Live.Word Processing Division in 1992. formulas are ALWAYS faster All languages map to the same core functionality Formulas are highly optimized LotusScript and Java are “higher level” languages Formulas are “closer to the iron” LotuScript Java @FORMULAS Bytecode Interpreter Formula Engine Core API Advisor. Inc. . and Speaker.com CIB306: What’s New in Formulas and LotusScript in ND8 .Page 3 ©2007 ADVISOR MEDIA.com Why are formulas still important? Given like functionality.Agenda Why are formulas still important? Review of what’s new in Formulas in ND8 New features in LotusScript in ND8 Questions Advisor. All Rights Reserved. Inc.New Formulas in ND8 @AbstractSimple Creates a short abstract of a text or rich text field. All Rights Reserved. but is a lot easier to use than the old @Abstract function @GetViewInfo (new attribute) [IsViewFiltered] Returns True (1) if the @SetViewInfo command has been used to filter which documents are displayed in the view. .com CIB306: What’s New in Formulas and LotusScript in ND8 .com New Formulas in ND8 @PasswordQuality examples added examples using @PasswordQuality with password encryption @URLQueryString now allows dynamic DB2 Query Views @UserRoles no database location limit @Version added new version numbers Advisor. False (0) otherwise @IsUsingJavaElement Indicates if a view or outline is using the new Java interface Advisor.Page 4 ©2007 ADVISOR MEDIA. and Speaker. com New in ND 8. could be… You can guess at what these may do @GetComponentViewPreference @IsInCompositeApp @ManageECL @Now ([NoCache]) – more on this in a minute @ShowParentPreview @RecoverIDFile @WhichFolders Advisor. All Rights Reserved. Inc. and Speaker.1 (MAYBE) Off the record. .New @Commands in ND8 @Command ([CalendarFormat]) added two work week and one work month formats @Command([CopySelectedAsTable]) Mimics the menu command @Command([OpenInNewWindow]) Mimics the menu command Advisor.com CIB306: What’s New in Formulas and LotusScript in ND8 . what I heard.0.Page 5 ©2007 ADVISOR MEDIA. Without this keyword. NotesDirectoryNavigator.0. NotesDocumentCollection.New in ND8.Page 6 ©2007 ADVISOR MEDIA. and more… Advisor. NotesPropertyBroker. NotesDXLExporter. Advisor. NotesDocument.com What’s New in LotusScript? New Classes NotesDirectory.when checking the time on a server forces a server transaction to fetch the time. Note that using [NoCache] adds the significant overhead of doing a server transaction on each call. . Inc. and compute the current time by adding the cached time and elapsed time. NotesViewEntryCollection.1. This causes problems if the system time on the client or server machine changes once the server time is cached. All Rights Reserved.@Now([NoCache]) @Now([NoCache]) . NotesProperty New Properties and Methods in… NotesDatabase. and Speaker. @Now would cache the server time on the first call. NotesView.com CIB306: What’s New in Formulas and LotusScript in ND8 . All Rights Reserved.com Directory Searching NotesDirectory. .Page 7 ©2007 ADVISOR MEDIA.GetMailInfo For a given username. Inc.Directory Searching The new NotesDirectory object represents the Domino Directory (ies) on the specified server Allows for Directory searching and navigation NOT available in Java Advisor.com CIB306: What’s New in Formulas and LotusScript in ND8 . and Speaker. returns the following: Mail server Mail file Mail domain Internet mail address Out of Office status …and more Advisor. and the item(s) to return Iterate the results using FindNextMatch and/or FindNextName navigator methods Retrieve items using GetFirstItemValue and/or GetNextItemValue methods of the navigator Advisor.Page 8 ©2007 ADVISOR MEDIA. . All Rights Reserved.com CIB306: What’s New in Formulas and LotusScript in ND8 .LookupNames Creates a NotesDirectoryNavigator with the results of the search You specify the view. Inc.Directory Searching NotesDirectory. and Speaker. the name(s).com Working with Composite Apps NotesPropertyBroker Supports the new Composite Application functionality Intermediary for communication between components (Notes-to-Notes or Notes-to-Java) Instantiated through the NotesSession object NOT available in Java Advisor. Using NotesPropertyBroker Use the InputPropertyContext to retrieve an array of NotesProperty objects Read the property value(s) using the NotesProperty methods Use the Publish method to publish back to the Property Broker Set the property value using the NotesProperty method SetPropertyValue Advisor. and Speaker. .com Example of NotesProperyBroker You have an example of NotesPropertyBroker that you can look at right now It is a part of Notes 8 Mail Provided to you as basic functionality for PIM connectivity in Composite Apps. All Rights Reserved. and as basic examples for creating actions in Composite Apps Review of Actions in Mail file Advisor.com CIB306: What’s New in Formulas and LotusScript in ND8 .Page 9 ©2007 ADVISOR MEDIA. Inc. various other objects (such as NotesDocument.you provide either a NoteID (string).com NotesDocumentCollection Some more interesting new methods Merge – you provide either a NoteID (string). and this merges the provided objects with the collection Subtract . .NotesDocumentCollection Some interesting new methods Clone – returns a NotesDocumentCollection object which is a copy of the original Contains – you provide either a NoteID (string). and Speaker. etc. NotesDocumentCollection. NotesDocumentCollection. etc. NotesDocumentCollection. etc. various other objects (such as NotesDocument. All Rights Reserved.) . etc. various other objects (such as NotesDocument. NotesDocumentCollection.) and it tells you if the NotesDocumentCollection contains all of the specified documents Intersect – you provide either a NoteID (string).) . Inc.).com CIB306: What’s New in Formulas and LotusScript in ND8 . and it removes them from the collection Same methods in the NotesViewEntryCollection class NOT available in Java Advisor. and it removes all docs not a member of both the collection and the provided docs Advisor. various other objects (such as NotesDocument.Page 10 ©2007 ADVISOR MEDIA. wrapped in a class Simply call the desired method Advisor.Page 11 ©2007 ADVISOR MEDIA.com CIB306: What’s New in Formulas and LotusScript in ND8 . . All Rights Reserved. Inc. and Speaker.Changes to Web Services ND7 introduced a new design element to make it easier to surface web services Consuming a web service from the client required some hoop jumping With ND8 there is a new design element to make it easier Web service enabled script library Advisor.com Web Service-Enabled Script Library Can be either Java or LotusScript Creates a class that can be used in other scripts All of the over-the-wire communication with the web service is obfuscated Hidden. have the WSDL file on your machine Create a new script library Click the new button at the bottom labeled “WSDL.Creating a Web Service Script Lib First..” Import the WSDL file This operation creates a class that represents the service Advisor. and Speaker.. .Page 12 ©2007 ADVISOR MEDIA. All Rights Reserved. Inc.com Using a Web Service Script Lib Include in the agent/action LotusScript: Use “MyScriptLibrary” Java: Edit Project – Shared Java Libraries Create an object of the class defined in the script library You may need to use the XSD data types to pass data Call the desired method Advisor.com CIB306: What’s New in Formulas and LotusScript in ND8 . Page 13 ©2007 ADVISOR MEDIA. Inc. All Rights Reserved.More Interesting Toys ReadViewEntries URL command &Outputformat=JSON JSON text instead of XML &EndView=1 Used with &Count=n to view the last n documents in the view &KeyType Specifies the type of StartKey text/time/number Advisor.com And Finally… New CGI variable Request_Content_nnn (000. etc) Allows HTTP POST requests to exceed 64 K Expands on the existing Request_Content variable Set doc = session.com CIB306: What’s New in Formulas and LotusScript in ND8 . . 001.GetItemValue(“Request_Content_000”)(0) Advisor. and Speaker.DocumentContext sRequest = doc. net Notes/Domino Gold Forum ND6 .ND8: www. .com/NotesFAQ Advisor Forum www.notes. Inc.LotusGeek.BIG THANKS!! To TROY REIMER of SNAPPS for help with these slides We did this deck together Advisor.com/ldd or www.com My blog – Lotus Geek www.com BPs ONLY: BP Forum 2007 (via LNN) Advisor.keysolutions.lotus.com/dNotes002.lotus.com/ldd/nd6forum.nsf Bob Balaban’s Blog www.com Resources Lotus Developer Domain (formerly Notes. and Speaker.com CIB306: What’s New in Formulas and LotusScript in ND8 .advisor. All Rights Reserved.Page 14 ©2007 ADVISOR MEDIA.nsf Lotus Notes FAQ www.BobzBlog.Net) www. Inc. All Rights Reserved. Advisor.com/cte0710p.Page 15 ©2007 ADVISOR MEDIA.nsf/w/cte0710ud This session WILL NOT have updates. . and Speaker.Q & A (aka “Stump the Chump”) Ask anything about Formulas or LotusScript Ask anything else about development in general Thanks.com CIB306: What’s New in Formulas and LotusScript in ND8 . and remember to fill out your evaluations! Advisor.com ADVISOR SUMMIT Web Update Page advisor.