@V4UserAccess (式言語)

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

注: この @関数は R5 で新しく追加されました。R4 で使用されていた @UserAccess は、R5 以降では自動的に @V4UserAccess に変換され、式の機能が維持されます。R5 以降では、@UserAccess によってより多くのユーザーアクセス情報が返されます。@UserAccess を使用するように式を変更する場合は、必ず新しいリリースで再コンパイルしてください。R5 以降で @UserAccess を使用するとき、データベースが R4 で作成されたものである場合は、データベースをアップグレードしなければ式は認識されません。式が R4 で評価される場合は、@V4UserAccess を使用してください。

構文

@V4UserAccess( server : file )

パラメータ

server

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

file

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

戻り値

level ; create ; delete

文字列リスト。

level は、データベースに対するユーザーのアクセスレベルを示す 1 から 6 までの数字です。

レベル

ユーザーのアクセスレベル

1

[投稿者]

2

[読者]

3

[作成者]

4

[編集者]

5

[設計者]

6

[管理者]
create には、ユーザーがデータベースに文書を作成できる場合は 1 (True)、できない場合は 0 (False) が返されます。
delete には、ユーザーがデータベースから文書を削除できる場合は 1 (True)、できない場合は 0 (False) が返されます。

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

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

使用法

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

例

次の式では、Galactica/Space/Federation サーバー上の DSource¥lookup.nsf データベースでユーザーに [編集者] のアクセス権が与えられ、文書の作成と文書の削除が許可されている場合は「4; 1; 1」が返されます。
```
@V4UserAccess( "Galactica//Space//Federation" : "dsource¥¥lookup.nsf" )
```
次の式では、ユーザーのアクセスレベルと許可とは関係なく「6;1;1」が返されます。customer.nsf データベースはローカルサーバー上で実行されているためです。データベースに対するユーザーのアクセス権が [なし] の場合は、「操作を実行する権限がありません」というメッセージが表示されます。
```
@V4UserAccess("":"¥¥Notes¥¥Data¥¥customer.nsf")
```
次の式では、現在のデータベースがローカルサーバーではないサーバーで実行されているとき、ユーザーに [管理者] のアクセス権が与えられ、文書の作成が許可されているが、文書の削除は許可されていない場合は、6; 1; 0 が返されます。
```
@V4UserAccess( @DbName )
```

クロスリファレンス

LotusScript® NotesDatabase クラスの QueryAccess メソッド

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

Java™ Database クラスの queryAccess メソッド

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