Lotus Domino Designer 8 ヘルプ - 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 型。Lotus Notes または Lotus 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: クラスリファレンス

アクセス制限リストを確認および調整する

ランタイムエラーを処理する

Lotus Domino のクラスを使用する

用語集

フィードバック ヘルプ または プロダクトユーザビリティ?

ヘルプの使い方

すべてのヘルプ項目

用語集