Some Notes on Xpages (or What I Did Over My Summer Holiday)
With props to John Mackey and Andrew Pollack for publishing tips that I leaned on in my work today. And a deep, ingratiating bow to Thomas Gumz for taking the time to talk to me about some tricky pieces on Thursday afternoon!
You must use Session-based authentication for Xpages.
applicationScope and sessionScope variables totally kick ass.
Finding all the detail controls for things like "what to iterate over in a repeat control" is some deep voodoo. But it's very satisfying once you find it.
When in doubt, Project - Clean is your friend.
Speaking of the Project menu, make sure "Build Automatically" is turned on. Unless you don't want it on -- in which case make sure you remember to Build before testing.
It's helped a lot to have a second machine on my desk, with 8.0.1, where I can do things like create new libraries, since that's broken in 8.5 Beta 1.
Screen real estate is VITAL when working with Eclipse. I already kinda knew this working with Component design, but now that we have visual editors for xpages and HUGE property sets for various controls, dual monitors is going to be a minimum requirement.
The Outline control is one of the most useful aspects of DDE (Domino Designer in Eclipse).
Debugging is a major challenge. Sometimes the engine throws a global error page. Sometimes it doesn't. Sometimes you have to just use the print () command in your server-side script to trace what's going on.
You MUST just open your mind and explore things. There's no way it's all going to get documented, and it's going to be years before there's a broad base of design patterns and tools to make things obvious. But you can learn a lot just by going to All Properties and reading the hover help on the properties labels.
The visual editor really only scratches the surface. Try this: create an Xpage. Go to the All Properties tab. Go down to the "data" section. Click on the property value and you'll see a little plus icon. Click it. Read the list of options. You won't be disappointed.
All the editors controls -- every place you type in text -- still need a LOT of work in DDE. The script editor is really rough, and you particularly don't want to try to use the mouse to select content in the script edit pane. But even some of the edit boxes in regular properties try to deal with type-ahead, and can drag on like a Friday afternoon in the summertime. (oh... wait... it IS Friday afternoon in the summertime!)
Okay... it's late.... probably no one will read this until Monday, but today is Independence Day, and that's exactly what I feel like I'm getting as I start trying to do some serious projects with Xpages!


