Presented by: Kathy Brown

Learning To Run - XPages for Lotus Notes Client DevelopersAn IdoSphere webinar

Who am I...

Kathy BrownLotus Notes Developer, primarily for the Notes client, until recentlyAuthor for The ViewCo-author of the Lotus User Group’s Notes Developer Tips NewsletterSpeaker at Lotusphere, The View’s Developer conference and several LUGsTwitter addictRunner

What this session is...

Tips and transitions for Notes client developers

What this session is not...

A step-by-step how toBest practicesAdvanced topics

What We’ll Cover

Building BlocksLanguagesMore

Building Blocks

FormsViewsSubformsFramesetsOutlinesPages

Building Blocks

Xpages Core controlsContainer controlsCustom controls

Separation of Data and UI

Traditional Notes DevForms combined data and UI

XpagesSeparate data from UI

Create forms just as data holders, no need to prettifyCreate views for lookups, no need to prettify (no need for dual sorting!)

Customer NameCustomer IDCustomer AddressCustomer Purchases

Widget IDWidget NameWidget DescriptionWidget Image

Customer NameCustomer AddressWidget IDWidget NameWidget Description

Data binding

Because the data and the UI are separate, we have to “bind” data to our elementsXpage

Can define a domino document or view as a data sourceCustom Controls and Container Controls like Panel

Can define a domino document or view as a data sourceRepeat Controls and certain Core Controls

Use data binding

Data binding

Simple data bindingSelect a source from a list, or add anotherSelect an item to bind toExample: select a document from the source and a field from that document to bind to

JavascriptUtilize the JavaScript editor to write server side javascriptExample: database.getView("movies by genre").getAllDocumentsByKey(genre);

AdvancedUse expression language, scoped variable, component parameter or custom code for data binding

DDE

Quick Tip

Window --> Reset Perspective is your friend

The Outline

Easily locate items on the XpageDrag & Drop items to new locations

Source

Easily change values or propertiesSee the Matrix

Design pane

NOT DONE

Properties

Core Controls

What’s with the “group” controls?

Something familiar*

Edit BoxRich TextMultiline Edit BoxList BoxCombo Box

*Sort of

Quick Tip

When adding @formula values for a combo box (or list box) the default condition is “Compute on Page Load”Remember to change that to “Compute Dynamically” in the script editor

OR go to the source and change the “$” to “#”

More Core Controls

Core Controls - Label

Why Use a Label?

More controlMore programmability

Core Controls - Errors

Use to ... display errors

Don’t forget to remove!

Panel Control

Sort of, kind of, like a layer...on steroids.Or like an embedded view...on steroids.Or like if a layer and an embedded view had a baby.

Repeat Controls

No Traditional Notes Client equivalentAnd that’s a good thing

A repeat control allows you to put controls inside (like Edit boxes or computed values, but also more repeat controls!) that repeat on the page

Container Controls

Include Page - allows you to include an Xpage inside another Xpage

Table - We know all about this one!

View - kind of like an embedded view, but better

Tabbed Panel - multiple panels with...tabs!

Section - We’ve seen this before, too

Custom Controls

Closest traditional equivalent are subformsCreate custom controls to hold other controls stored togetherCan be a “create once, use multiple times” control for footers or headers, for example

CTRL+SHIFT+F in the source

Quick Tip

@Formula in XPages

@Formula is available for use in Server Side JavaScript (SSJS)Not all @Formula are supported in XPages

@Functions Not Supported in XPages

@AbstractSimple @CheckAlarms @DeleteField @DoWhile

@Accessed @CheckFormulaSyntax @DialogBox @EditECL

@ACos @Command @DocChildren @EditUserECL

@AddToFolder @Compare @DocDescendants @EnableAlarms

@AdminECLIsLocked @ConfigFile @DocFields @Environment

@All @Cos @DocLength @Eval

@AllChildren @DB2Schema @DocLevel @Exp

@AllDescendants @DbCommand @DocLock @FileDir

@Ascii @DbExists @DocMark @FloatEq

@ASin @DbManager @DocNumber @FontList

@ATan @DDEExecute @DocOmmittedLength @For

@ATan2 @DDEInitiate @DocParentNumber @FormLanguage

@BrowserInfo @DDEPoke @DocSiblings @GetAddressBooks

@BusinessDays @DDETerminate @DocumentUniqueID @GetCurrentTimeZone

@Certificate @DeleteDocument @Domain @GetDocField

@Functions Not Supported in XPages (cont.)

@GetFocusTable @IsDocBeingRecalculated @Locale @OrgDir

@GetHTTPHeader @IsDocTruncated @Log @Password

@GetIMContactListGroupNames @IsEmbeddedInsideWCT @MailDbName @PasswordQuality

@GetPortsList @IsExpandable @MailEncryptSavedPreference @Pi

@GetProfileField @IsInCompositeApp @MailEncryptSentPreference @PickList

@GetViewInfo @IsModalHelp @MailSavePreference @Platform

@HardDeleteDocument @IsUsingJavaElement @MailSend @PolicyIsFieldLocked

@HashPassword @IsValid @MailSignPreference @PostedCommand

@InheritedDocumentUniqueID @IsVirtualizedDirectory @Matches @Power

@IsAgentEnabled @Keywords @NameLookup @Prompt

@IsAppInstalled @LanguagePreference @Narrow @RefreshECL

@IsCategory @LaunchApp @NoteID @RegQueryValue

@IsDB2 @LDAPServer @Nothing @Responses

@IsDocBeingEdited @Like @OpenInNewWindow @ServerAccess

@IsDocBeingMailed @Ln @OptimizeMailAddress @ServerName

@Functions Not Supported in XPages (cont.)

@Set @TemplateVersion @URLHistory @ViewTitle

@SetDocField @ThisName @URLOpen @WebDbName

@SetEnvironment @ThisValue @UrlQueryString @WhichFolders

@SetHTTPHeader @TimeMerge @UserAccess @While

@SetProfileField @TimeToTextInZone @UserNameLanguage @Wide

@SetTargetFrame @TimeZoneToText @UserNamesList @Zone

@SetViewInfo @ToNumber @UserPrivileges DEFAULT

@ShowParentPreview @ToTime @UserRoles ENVIRONMENT

@Sign @Transform @V2If FIELD

@Sin @Unavailable @V3UserName REM

@Sort @UndeleteDocument @V4UserAccess SELECT

@Soundex @UpdateFormulaContext @ValidateInternetAddress

@Sqrt @URLDecode @VerifyPassword

@StatusBar @URLEncode @Version

@Tan @URLGetHeader @ViewShowThisUnread

@Formula Syntax

Three syntactic changes to use @Formula in XPages:Use commas rather than semicolonsUse exact case

Example:var uname = @Name(“[CN]”, @UserName())

“null” should be used in place of 0 for formulas such as @AdjustExample:

var adate = @Adjust (@Created(), null, null, 5, null, null, null)

@Formula Help

@Formula Help

Help file is not very helpful! @Name(“[CN]”, name) – needs those quotes! But there is no example in the help file to demonstrate that!@UserName() – needs those parentheses! Again, no example in the help file to show that!

@Name in Help

Server Side Javascript (SSJS)

Server Side JavaScript is not LotusScriptClose enough to fool youGet this - http://bit.ly/XpagesMapLearn about recycling

http://bit.ly/Recycle1http://bit.ly/Recycle2

Close...

But not quite

Scoped Variables

applicationScopesessionScopeviewScoperequestScope

Xpages Domino Object Map

Turn off “Synchronize Navigator with Editor Tab”

Quick Tip

CSS and Themes

Roll your own orStart with a framework*

http://bit.ly/XpageFrameworkhttp://blueprintcss.org/

David Leedy may cover this in his session

*Start with a framework

Firebug

Where to get help...or not

Help files not so helpful

http://www-10.lotus.com/ldd/ddwiki.nsf

http://www-10.lotus.com/ldd/ddwiki.nsf/dx/NotesDocumentCollection_sample_JavaScript_code_for_XPages

Quick Tip

Create different search scopes for the Help file

Learn Javascript and Java

Javascripthttp://www.w3schools.com/js/default.asphttp://bit.ly/JavaScriptDefinitive

Javahttp://bit.ly/HeadFirstJava

Test Server - Get one

Typical Lotus Client development can get away with “testing” on a production server

Doing that with Xpages...

Sample applications - get some

Download applications and dig through them to see how they were created

Frameworks on OpenNTFMatt White and Tim Clark’s Show and Tell sample app

Turn on “Select controls dialog box”

Quick Tip

Visible versus Hide When

Quick Tip

Upgrade whenever possible

Quick Tip

Learn Eclipse

Quick Tip

Resources

http://xpages101.net/http://notesin9.com/Wikis - see earlier slidehttp://xpag.es/?cheatsheetPlanetLotus.orgOpenNTF.orgTLCC.com http://bit.ly/fIlpHn - all the bit.ly links bundled

THANK YOU!

Any Questions?

Your Logo

How to contact me:Kathy Brown

The Consultant in your Pocket webcast series: find us at http://consultantinyourpocket.com

•E-mail: kathy@runningnotes.net•Twitter: kjbrown13 or NotesDevTips

•My Website: http://runningnotes.net