指定されたユーザー名をすべての Domino ディレクトリで検索し、ユーザー名ごとに 1 つの文字列値を格納したリストを返します。

メモ この @関数は R5 で新しく追加されました。

構文
@NameLookup( [ lookupType ] ; username; itemtoreturn )

パラメータ
[ lookupType ]

キーワード。実行する検索の種類を指定します。次のキーワードを 1 つ以上指定します。

[NOUPDATE]

デフォルトです。ユーザー名のリストを返します。Notes API の NAME_LOOKUP_NOUPDATE フラグに対応します。このキーワードは、[FORCEUPDATE] キーワードを除く他のキーワードと共に指定できます。

[FORCEUPDATE]

ネームスペース (ビュー) を強制的に更新します。Notes API の NAME_LOOKUP_UPDATE フラグに対応します。このキーワードは、[NOUPDATE] キーワードを除く他のキーワードと共に指定できます。

以下のキーワードは、[NOUPDATE] キーワードまたは [FORCEUPDATE] キーワードと共に指定できます。

[NOSEARCHING]

「($Users)」ビューが含まれている最初の Domino ディレクトリ (つまり、ローカル Names.nsf データベース) のみを検索し、指定されたユーザー名ごとに 1 つの文字列値を格納したリストを返します。このキーワードは、メールサーバーのディレクトリからは値を取得しないことを指定します。一致するものが見つからなければ、空の文字列 ("") を返します。Notes API の NAME_LOOKUP_NOSEARCHING フラグに対応します。

[EXHAUSTIVE]

notes.ini の NAMES 変数に指定されたすべての Domino ディレクトリを検索し、すべての情報を文字列リストで返します。このキーワードは、ローカル Names.nsf データベースからの値だけでなく、メールサーバーのディレクトリからの値も返します。メールサーバーが利用可能でない場合は、現在のネームサーバーから値を取得します。LDAP が使用されている場合は、LDAP ディレクトリからも値を取得します。一致するものが見つからない場合は、ユーザーの値は省略されます。

[TRUSTEDONLY]

信用情報が含まれている Domino ディレクトリだけを検索し、指定されたユーザー名ごとに 1 つの文字列値を格納したリストを返します。一致するものが見つからなければ、空の文字列 ("") を返します。Notes API の NAME_LOOKUP_TRUSTED_NAMESPACES フラグに対応します。

文字列または文字列リスト。Domino ディレクトリから情報を取り出す Notes/Domino のユーザー名またはその別名を指定します。

文字列。情報を取り出す Domino ディレクトリ連絡先文書のアイテム名またはフィールド名です。

文字列リスト。[EXHAUSTIVE] 以外のフラグを指定した場合は、指定したユーザーごとに 1 つの値を格納したリストが返されます。一致するものが見つからなければ、空の文字列 ("") を返します。[EXHAUSTIVE] を指定した場合は、指定したユーザーに関して一致したすべての情報のリストが返されます。一致しなかったユーザーについては、値は返されません。この戻り値を @Prompt を使ってダイアログボックスに表示するには、@Text 関数でこの関数を囲みます。

LDAP ディレクトリの検索について詳しくは、「インターネットディレクトリで宛先を検索するよう Notes を設定する」を参照してください。

例