|
|
|
|
|
|
|
|
|
|
|
|
|
|
PROGRAMMING TRICKS
Reusing the Web address dialog from the R5 mail template
By Glenn S. Orenstein
In developing Web-based applications in Domino R5, I often find it necessary to provide a means to select names of individuals or groups from a Domino directory (address book). Although I could spend a great deal of effort in creating a form and programming the code necessary to do the job, I've found a simple, elegant way to circumvent the development effort entirely.
Everything you need
The standard R5 Web-enabled mail database template contains everything you need to provide a robust, Web-based dialog to select entries from an address book. By using the Lotus-developed code without modification, you can provide users with the ability to select on the basis of any of the following:
- Multiple user and group names returned into the three standard email address fields (SendTo, CopyTo, and BlindCopyTo);
- A single user or group name;
- Multiple user and group names returned into a single field.
In addition, the dialog can be used to copy person documents from an address book to your application's database. Which format of the address dialog presents itself and how it gets used depends on the code you use to invoke it.
A number of simple modifications can make the address dialog even more useful and powerful. You can change the names of the address book(s) that are used, you can change the names of the fields into which results are returned, and you can change the format of the names that are returned to you.
What it looks like
Figure A shows the address dialog with the usual email fields: To, Cc, and Bcc.
FIGURE A
 
The standard dialog selects multiple names into three fields. Roll over picture for a larger image.
When used in this manner, the address dialog will return selected names to your form in fields called SendTo, CopyTo, and BlindCopyTo. This is the default version of the dialog.
Figure B shows the address dialog in its simplest form--selecting a single name from an address book.
FIGURE B
 
The "Delegate" dialog selects one name into a single field. Roll over picture for a larger image.
The resulting name will be returned to your form in a field called Delegee. The Lotus developers called this the "Delegate" dialog. As you'll see, that name is important in invoking the address dialog.
A slightly more elaborate version of the address dialog is shown in Figure C.
FIGURE C
 
The "Group" dialog selects multiple names into a single field. Roll over picture for a larger image.
This format allows your users to select multiple names from an address book. All names will be returned to a single multi-value field called "Members." Again, the name is case-sensitive. This is referred to as the "Group" dialog.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-- 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. |
|
|
|
|
|
|
|
|
|
|
