Searches for each specified user name across all Domino Directories and returns a list of single text values for each specified user name.

Note This @function is new with Release 5.

Syntax

@NameLookup( [ lookupType ] ; username; itemtoreturn )

Parameters

[ lookupType ]

Keyword. Specifies the type of lookup to perform. Supply one or more of the following keywords:

[NoUpdate]

Default. Returns a list of user names. Corresponds to NAME_LOOKUP_NOUPDATE flag for Notes API. You can specify this keyword along with the other keywords excluding [ForceUpdate].

[ForceUpdate]

Forces the name space (view) to be updated. Corresponds to NAME_LOOKUP_UPDATE flag for Notes API. You can specify this keyword along with the other keywords excluding [NoUpdate].

The following keywords can be used along with the [NoUpdate] or [ForceUpdate].

[NoSearching]

Searches only the first Domino Directory containing the "($Users)" view, which is the local Names.nsf database, and returns a list of single text values for each specified user name. This keyword specifies to not retrieve values from the mail server's directory. An empty string is returned for no match found. Corresponds to NAME_LOOKUP_NOSEARCHING flag for Notes API.

[Exhaustive]

Searches all Domino Directories listed in the Notes Directory Assistance and returns all information in a text list. This keyword returns values from the local Names.nsf database as well as the mail server's directory. If the mail server is unavailable, or the Recipient name type ahead setting in the current location document is Disabled or Local Only, it retrieves values from the current name server. If you are using LDAP, it also retrieves values from the LDAP directory. The user's value is omitted if there is no match found.

[TrustedOnly]

Searches only those Domino Directories that contain trust information and returns a list of single text values for each specified user name. An empty string is returned for no match found. Corresponds to NAME_LOOKUP_TRUSTED_NAMESPACES flag for Notes API.

Text or text list. Specify primary or alternate Notes/Domino user names to retrieve their information from the Domino Directory.

Text. Item or field name from the Domino Directory Contact record that you would like to retrieve information from.

valuelist

Text list. When other flags besides [Exhaustive] have been specified, @NameLookup returns a list of single values for each specified user. An empty string is returned for no match found. When [Exhaustive] has been specified, @NameLookup returns a list of all information matched for the specified user. No value is returned for unmatched users. To display the return values in a dialog box using @Prompt, enclose this function in an @Text function.

@NameLookup cannot be used in form selection and view column formulas.

To enable server directory data to be included in this function's return value, the Recipient name type ahead setting in the Mail tab of the current location document must be set to Local Then Server.

All the users from secondary directories, including the LDAP directory, need to be authenticated first, and then authorized to access a Notes/Domino database administered by the Domino server. The Directory Assistance derived from the Master Domino Directory uses trusted name rules to authenticate users. Once a user name is authenticated, it is added to the list of trusted names. This user name is then compared to the ACL for authorization.

For more information on searching the LDAP directory, see "Setting up Notes to search an Internet directory for addresses" in the Lotus Notes Help.

Example

Glossary