Search DominoPower's 11,974 Lotus-related article archive 
Home
EasyPrint
News details Click here for the RSS feed's XML code. This is not a browser URL.
Articles-only Click here for the RSS feed's XML code. This is not a browser URL.
Twitter Feed Click here for the Twitter feed.
GETTING HELP
Creating context sensitive field help with dialog boxes
By Chris Doig

How many times have you been clueless when completing a field on a form? You clicked on a pick list or combo box and were faced with an almost meaningless list of choices. The unsaid things that were so obvious when the program was created have been forgotten. While this gets embarrassing when you're the program author, the real problem is that the context has been lost. You feel a bit like Bill Gates when those ancient emails were resurrected in court. What was unsaid and forgotten (i.e., the context) was just as important a part of the communication as that which was said.

The usual solution to this problem is context sensitive field help. Developer tools for writing user help in Notes have improved over the years, but field help is still pretty dismal. While the main advantage of Notes field help is that it's tied programmatically to the field, it has several problems:

  • You often need a lot more space than the 70 characters that field help provides. If you write multilingual applications, you're advised to limit this to 55 characters;

  • The user might have field help turned off;

  • Even if field help is turned on, the user might not notice it because there's no visual connection with the field;

  • If you use a computed field with, say, a button to set the field values, the user can't get at the field help;

  • Field help doesn't work on the Web.

In this article, we'll explore the idea of using dialog boxes to solve the context sensitive field help problem in the Notes client. I'll show some examples to give you an idea from the usability perspective. Then I'll show you how to construct a help form and the code used to call it. Along the way, we'll cover design techniques and conclude with a few ideas for enhancements.

Pros and cons
The help dialog approach has several powerful advantages, but, like most things in Notes, there are significant trade-offs. One of the first things you'll notice is that dialog boxes are modal, which means the user can't complete the form with the dialog box open. To solve this, we use the fact that a dialog box opens the current document with a different form. So you can put the actual document field on the help form, right next to your explanation. This really holds the context together. The user opens the help, completes the field, and presses OK. Then the user is returned to the main document with the field updated.


1  ·  2  ·  3  ·  4  ·  Next »
Other articles you might like
Home > Lotus Technologies > Notes (84 articles)
   A walk down Memory Lane with Lotus Notes
   An application for scanning physical mail and distributing it virtually
   Managing Notes deployments with Teamstudio Build Manager
Home > Lotus Technologies > LotusScript (64 articles)
   When the debugger won't debug hidden code that isn't hidden
   What to do if the LotusScript debugger won't single-step over code
   Little known traps about Lotus Notes fields
Home > Lotus Technologies > Application Development (48 articles)
   An application for scanning physical mail and distributing it virtually
   How hide-whens in Rich Text can ruin your whole day (and what to do about it)
   Little known traps about Lotus Notes fields
Get Weekly Email Updates
Subscribe to our regular weekly email newsletter. It's packed with tips, reviews, deep analysis, and the latest news.
 
Recent DominoPower Articles
Lotus must open source Notes and Domino
It's time for Lotus to double-down on Linux and open source
Back to basics with Notes: what you can do now
Back to basics with Notes: what are the basics?
Back to basics with Notes
Smart Upgrade bug in Domino 8.5.1 (and some work-around tips)
Hands-on with XPages and the Lotus Solutions Catalog
Latest Lotus Headlines
IBM Lotus Notes 8.5.2: Upgrading your Icons from 16x16 to 32x32
IBM killed the Sandbox !
Followup on Cut and Paste problem in 8.5.2
Save us from our users: Doomsday Weekend 3
iNotes 8.5.2 Security Change With XSS
Warning about multiple Traveler installations in your domain
Admins: Modifying, Updating or Fixing your Config
>> Read all the news
More from the ZATZ journals
Computing Unplugged: Introducing the Jones family and their full-family backup challenges
David Gewirtz Online: CNN commentary and analysis
OutlookPower: Hands on debugging a broken Outlook forwarding rule
-- Advertisement --

Navigate the Document 'SharOllaboraGement' Universe
More than 60% of organizations are dealing with 'Content Chaos' -- Out of control Documents and Content.

Unfortunately, over 50% of those will rush into the wrong solution and ultimately fail.

The Document & Content Management Decision Matrix is a free tool for navigating the broad 'Document Sharing, Collaboration and Management' technology universe.

Use it to help you make the right decision based on your organizational preferences and needs.

Tap to download this complementary tool.

-- Advertisement --

Want the top Lotus experts by your side without paying hefty consulting fees?
Look no further.

Like having a team of consultants by your side -- ones who have all the answers and never make mistakes -- THE VIEW gives you immediate access to field-tested instruction, guidance, and best practices from the brightest Lotus professionals around.

See the new instruction, advice, and best practices added to THE VIEW this week.

ZATZ Home  ·  News  ·  Back Issues  ·  Credits/Trademarks ·  Link To Us
Copyright © 1998-2010, ZATZ Publishing. All rights reserved worldwide.
Editor's Login