Lotus Domino Designer 8.5 ヘルプ - 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 のクラスを使用する

用語集

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

ヘルプの使い方

すべてのヘルプ項目

用語集