Lotus Domino Designer 7 ヘルプ - NotesDatabase クラス

サーバーとファイルの名前が分かっている既存のデータベースにアクセスするには、New メソッド、または NotesSession の GetDatabase メソッドを使います。
スクリプトが現在実行されているデータベースにサーバー名やファイル名を指定しないでアクセスするには、NotesSession の CurrentDatabase プロパティを使います。
サーバーとレプリカ ID が分かっている既存のデータベースにアクセスするには、OpenByReplicaID メソッドを使います。
サーバー名は分かっていてもファイル名が分からない既存のデータベースにアクセスするには、NotesDbDirectory クラスを使います。
現在のユーザーのメールデータベースにアクセスするには、OpenMail メソッドを使います。
デフォルトの [Web ナビゲータ] データベースを開くには、OpenURLDb メソッドを使います。
使用可能なアドレス帳にアクセスするには、NotesSession の AddressBooks プロパティを使います。
アクセスする前にサーバー名とファイル名を指定してデータベースの存在を確認するには、IsOpen、Open、OpenIfModified などのプロパティやメソッドを使います。
既存のデータベースから新規データベースを作成するには、CreateCopy、CreateFromTemplate、CreateReplica のうちいずれかのメソッドを使います。
まったく新規にデータベースを作成するには Create メソッドを使います。
データベースの NotesView、NotesDocument、NotesDocumentCollection、NotesACL、NotesAgent のいずれかを取得している場合は、Parent または ParentDatabase プロパティを使います。

New
メモ New メソッドは COM ではサポートされていません。

指定されたサーバーとファイル名のデータベースを表す NotesDatabase オブジェクトを作成し、そのデータベースを開きます。NotesDatabase で New を使うと、NotesDocument などの他のクラスで使う場合とは異なり、新規データベースをディスク上に作成しません。

構文
Dim variableName As New NotesDatabase( server$, dbfile$ )

または

Set notesDatabase = New NotesDatabase( server$, dbfile$ )

パラメータ
server$

String 型。データベースがあるサーバーの名前です。空の文字列 ("") を使うと、現在のコンピュータのデータベースが指定されます。スクリプトがクライアントで実行されるとき、空の文字列はローカルデータベースを示します。スクリプトがサーバー上で実行されるとき、空の文字列はそのサーバーのデータベースを示します。

dbfile$

String 型。Notes または Domino のデータディレクトリにあるデータベースのパスとファイル名です。後でデータベースを開きたいときは、

dbfile$

と

server$

の両方に空の文字列を指定します。データベースが Notes データディレクトリにないときは、フルパス名で指定します。

戻り値
notesDatabase

指定されたデータベースのアクセスに使う NotesDatabase オブジェクトを返します。

指定された server$ と dbfile$ にデータベースが存在するときは、NotesDatabase オブジェクトが開かれ、スクリプトはオブジェクトのすべてのプロパティとメソッドにアクセスできます。
指定された server$ と dbfile$ にデータベースが存在しないときは、NotesDatabase オブジェクトは閉じています。指定された位置に新規にデータベースを作成するには、この NotesDatabase オブジェクトと Create メソッドを使います。

使い方
スクリプトがデータベースに対応する NotesDatabase オブジェクトのプロパティとメソッドを使うには、データベースが開かれていなければなりません。ほとんどの場合、クラスライブラリが自動的にデータベースを開きます。ただし、次の場合に注意してください。

スクリプトがアクセス権を持たないデータベースを開こうとするとエラーになります。スクリプトがデータベースを開くためには [読者] 以上のアクセス権が必要になります。
NotesDbDirectory オブジェクトから取得した NotesDatabase は閉じています。閉じているデータベースで使えるのは、Categories、DelayUpdates、DesignTemplateName、FileName、FilePath、IsOpen、Parent、ReplicaID、Server、SizeQuota、SizeWarning、TemplateName、Title の各プロパティです。NotesDbDirectory から取得したデータベースのすべての他のプロパティとメソッドにアクセスするには、スクリプトはデータベースを明示的に開かなければなりません。
NotesSession の AddressBooks プロパティから取得した NotesDatabase は閉じています。閉じているデータベースで使えるのは、FileName、FilePath、IsOpen、IsPrivateAddressBook、IsPublicAddressBook、Parent、Server の各プロパティです。AddressBooks プロパティから取得したデータベースのすべての他のプロパティとメソッドにアクセスするには、スクリプトは明示的にデータベースを開かなければなりません。
指定された server$ と dbfile$ にデータベースがないときには、New を使って取得された NotesDatabase は閉じています。閉じているデータベースで使えるのは、FileName、FilePath、IsOpen、Parent、Server の各プロパティです。

データベースが開いているかどうかを調べるには IsOpen プロパティを使います。閉じているデータベースを開くには Open または OpenIfModified を使います。

アクセスレベル
スクリプトがアクセス権を持たない操作を実行しようとするとエラーが起きます。NotesDatabase オブジェクトでスクリプトが使えるプロパティとメソッドは、次の要因で決定されます。

データベースに対するスクリプトのアクセスレベル。これは、データベースのアクセス制御リスト (ACL) で決定されます。スクリプトがデータベースを開けるかどうか、文書のデータベースへの追加、削除、ACL の変更などが可能かどうかは ACL で決定されます。
データベースのサーバーに対するスクリプトのアクセスレベル。これは Domino ディレクトリのサーバー文書で決定されます。エージェントの実行可能時間と利用できる LotusScript の機能は、サーバー文書で決定されます。

スクリプトがサーバーで実行されるとき、データベースとサーバーに対するスクリプトのアクセスレベルは、スクリプトの所有者のアクセスレベルに従います。所有者とはスクリプトを最後に保存したユーザーを指します。スクリプトがクライアントで実行されるときは、データベースとサーバーに対するアクセスレベルは、現在のユーザーのアクセスレベルに従います。

クロスリファレンス
式言語の FileDatabaseInfo @コマンド

例
関連項目

LotusScript: クラスリファレンス

用語集

用語集