サーバーとファイル名で指定されたデータベースに対する現在のユーザーのアクセスレベルを調べます。

メモ R4 で使用されていた @UserAccess は、R5 以降では自動的に @V4UserAccess に変換され、式の機能が維持されます。@UserAccess を使用するように式を変更する場合は、必ず R5 で再コンパイルしてください。R5 で @UserAccess を使用するとき、データベースが R4 で作成されたものである場合は、データベースを R5 にアップグレードしなければ式は認識されません。式が R4 で評価される場合は、@V4UserAccess を使用してください。

メモ AccessPrivilege キーワードは Release 6 で新しく追加されました。

構文

@UserAccess( server :file ; [ accessPrivilege ] )

パラメータ

server

文字列。サーバーの名前です。ローカルコンピュータの場合は空の文字列 ("") を使用します。

文字列。データベースのパスとファイル名です。データベースのパスとファイル名は、使用するオペレーティングシステムに適した形式を使用して指定します。

キーワード。省略可能。ユーザーのアクセス情報がすべて含まれているリストではなく、ユーザーのアクセスレベルが返されるようにする場合や、特定のデータベース権限があるかどうかを調べる場合は、以下のキーワードのいずれかを指定します。
• [ACCESSLEVEL] を指定すると、データベースに対するユーザーのアクセスレベルを示す 1 から 6 までの数値が返されます。

  レベル	ユーザーのアクセスレベル
  1	投稿者
  2	読者
  3	作成者
  4	編集者
  5	設計者
  6	管理者

以下のキーワードで指定した権限がユーザーに与えられている場合は 1 (True) が返され、そうでない場合は 0 (False) が返されます。これらの権限は、データベースのアクセス制御リストで指定されています。
• [CREATEDOCUMENTS]
• [DELETEDOCUMENTS]
• [CREATEPERSONALAGENTS]
• [CREATEPERSONALFOLDERSANDVIEWS]
• [CREATELOTUSSCRIPTJAVAAGENTS]
• [CREATESHAREDFOLDERSANDVIEWS]
• [READPUBLICDOCUMENTS]
• [WRITEPUBLICDOCUMENTS]
• [REPLICATEORCOPYDOCUMENTS]

1 つ以上のキーワードを指定すると、以下の値を格納した文字列値または文字列リストが返されます。

• [AccessLevel] キーワードを指定した場合は、1 から 6 までの値が返されます。
• その他のキーワードを指定した場合は、1 または 0 の値が返されます。

• [AccessLevel] :[CreateDocuments] :[DeleteDocuments] :[CreatePersonalAgents] :[CreatePersonalFoldersAndViews] :[CreateSharedFoldersAndViews] :[CreateLotusScriptJavaAgents] :[ReadPublicDocuments] :[WritePublicDocuments]

  デフォルトでは、ReplicateOrCopyDocuments へのアクセス権限があるかどうかは返されません。

  ヒント 式が保存されているフィールドの複数値分離記号がセミコロンのときは、返される文字列リストの値はコロンではなくセミコロンで区切られます。

[このデータベースのレプリカはすべて共通のアクセス制御リストを用いる] が有効になっていないローカルデータベースでは、2 番目のパラメータの指定がない @UserAccess は常に 6; 1; 1; 1; 1; 1; 1; 1; 1 を返します。データベースに対する現在のユーザーのアクセス権が [なし] の場合は「操作を実行する権限がありません。」というメッセージが表示されます。

この関数は列式、選択式、サーバー上で実行されるエージェント (メールエージェントとスケジュールが設定されているエージェント) では使用できません。そのため、Evaluate ステートメントとともに使用することはできません。

クロスリファレンス

LotusScript NotesDatabase クラスの QueryAccess メソッド

LotusScript NotesDatabase クラスの CurrentAccessLevel プロパティ

Java Database クラスの queryAccess メソッド

Java Database クラスの CurrentAccessLevel プロパティ

例
関連項目

@V4UserAccess
ユーザー環境にアクセスする

用語集