Lotus Domino Designer 8 Help - Examples: @Prompt

FORMULA LANGUAGE

Examples: @Prompt
1. [Ok] displays an informational message; the user clicks OK to close the dialog box. Use this style when you want to inform the user about something, without receiving anything back except an acknowledgement.

@Prompt([Ok];"Reminder";"Don't forget to run backup tonight.")

2. [YesNo] displays a warning, and gives the user a chance to proceed or cancel the operation. If the user selects Yes the numeric value 1 is returned. If the user selects No the numeric value 0 is returned.

@Prompt([YesNo]; "Send memo?"; "This memo will be sent to everyone listed in the To, CC, and BCC fields.")

3. [YesNoCancel] also displays a warning, and gives the user a chance to select Yes, No, or Cancel. If the user selects Cancel, the value -1 is returned.

result=@Prompt([YesNoCancel]; "Send memo?"; "This memo will be sent to everyone listed in the To, CC, and BCC fields" )

4. [OkCancelEdit] prompts the user to enter his or her name, which is returned as a text string. The name defaults to the current user's Notes/Domino user name, which is calculated using @UserName. If the user selects Cancel, Lotus Notes/Domino cancels the formula evaluation. Note that @Prompt([OkCancelEdit]) returns only the first 254 characters of the text entered.

@Prompt([OkCancelEdit]; "Enter Your Name"; "Type your name in the box below."; @UserName)

5. [OkCancelList] displays a list box with database names (sorted alphabetically), prompts the user to select a database, and returns that database's name as a text string for use in a subsequent operation. If the user selects Cancel, Lotus Notes/Domino cancels the formula evaluation.

The third option in the list is the current user's own mail database, the name of which is calculated with @MailDbName. The user must select one of the listed options; by default, Schedule is highlighted (the value listed as the default must also be included in the display list).

@Prompt([OkCancelList]; "Select a Database"; "Select a database to open."; "Schedule"; "Schedule":"Phone Book":@Subset(@MailDbName;1))

6. [OkCancelCombo] displays a dialog box similar to example 5, except that a drop-down list is used, so that initially only the default value is displayed. The user clicks the down arrow on the box to display the rest of the list. As in example 5, the user must select one of the listed values; by default, Schedule is selected. This function returns the user's selection. If the user selects Cancel, Lotus Notes/Domino cancels the formula evaluation.

@Prompt([OkCancelCombo]; "Select a Database"; "Select a database to open."; "Schedule"; "Schedule":"Phone Book":@Subset(@MailDbName;1))

7. [OkCancelEditCombo] is similar to example 6, except here the user can edit the text box and type in any database name; this way, the user is not limited to the selections in the list. This function returns the user's selection or entry. If the user selects Cancel, Lotus Notes/Domino cancels the formula evaluation.

The default value must be included in the list, or the text box that displays initially will be blank.

@Prompt([OkCancelEditCombo]; "Select a Database"; "Select a database to open, or type a database specification."; "Schedule"; "Schedule":"Phone Book": @Subset(@MailDbName;1))

8. [OkCancelListMult] displays a list of names, from which the user can select one or more (Mary Tsen appears as the default selection). This function returns the user's selection(s). If the user selects Cancel, Lotus Notes/Domino cancels the formula evaluation.

The default value must be included in the list.

@Prompt([OkCancelListMult]; "Select a Name"; "Select one or more names as recipients for this request."; "Mary Tsen"; "Mary Tsen":"Bill Chu": "Michael Bowling":"Marian Woodward")

9. [Password] displays a dialog box where the user can enter a password. Lotus Notes/Domino does not display the password on the screen. This function returns the password.

@Prompt([Password]; "Password"; "Enter the password for Approach database.")

10. [LocalBrowse] provides controls and displays that allow you to browse and select a name from the local file system. This example opens the Notes/Domino database file the user selects from the local browser. The "1" restricts the initial display to .nsf files.

file := @Prompt([LocalBrowse]; "Select a database to open"; "1"); @If(file = ""; @Return(1); ""); @Command([FileOpenDatabase]; "" :@Left(file; " "))

11. This code, in a form hotspot button, displays the Choose Database dialog box then sets field values on the document (which must be in edit mode) based on the result.

result := @Prompt([ChooseDatabase];"";""); FIELD Server := result[1]; FIELD Filename := result[2]; FIELD Title := result[3]

See Also

@Prompt

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary