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

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

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

パラメータ
[ lookupType ]

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

[NoUpdate]

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

[ForceUpdate]

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

以下のキーワードは、the [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 ディレクトリを含む 2 次ディレクトリからの全ユーザーは、最初に認証が必要です。続いて Domino Server によって管理される Notes/Domino データベースに対するアクセスが許可されます。マスター Domino ディレクトリから派生したディレクトリアシスタンスは、信頼された名前の規則を使ってユーザーを認証します。認証されたユーザー名は、信頼された名前のリストに追加されます。次に、アクセス許可のためにこのユーザー名と ACL との比較が行われます。

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

例