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, 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_NOSEARCHING flag for Notes API.

[EXHAUSTIVE]

Searches all Domino Directories listed in NAMES variable in notes.ini and returns all information in a text list. 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.

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.

Example