NotesDocument (LotusScript)

データベース内の文書を表します。

包含関係

NotesDocument オブジェクトを新規作成するには、次のどちらかを使用します。

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

New は指定されたデータベースに文書を作成して、文書を表す NotesDocument オブジェクトを返します。新規文書をディスクに保存するには、Save を呼び出す必要があります。

Dim variableName As New NotesDocument( notesDatabase )

または

Set notesDocument = New NotesDocument( notesDatabase )

notesDatabase

新規文書を作成するデータベースです。

既存のデータベースにアクセスするには、次のような方法があります。

文書をビューの中の位置に基づいて取得するには、NotesView を使用します。
文書を返答階層の中の位置をもとに取得するには、NotesView を使用します。
文書を文書 ID か UNID をもとに取得するには、NotesDatabase の GetDocumentByID かGetDocumentByUNID を使用します。
データベース内のすべての文書を取得する場合は、NotesDatabase の AllDocuments を使用します。
ビューかデータベースの全文検索の検索条件と一致する文書すべてを取得するには、NotesView か NotesDatabase の FTSearch を使用します。
式言語で定義された検索条件を満たすデータベースのすべての文書を取得するには、NotesDatabase の Search を使用します。
現在のエージェントによって処理されていないデータベースの文書を取得するには、NotesDatabase の UnprocessedDocuments、UnprocessedFTSearch、UnprocessedSearch のどれかを使用します。
特定の文書のすべての返答文書を取得するには、NotesDocument の Responses プロパティを使用します。
返答文書の親文書を取得するには、NotesDocument の ParentDocumentUNID プロパティと NotesDatabase の GetDocumentByUNID メソッドを使用します。

ビューを取得すると、NotesView クラスのメソッドを使用して任意の文書にアクセスできます

文書のコレクションを取得すると、 NotesDocumentCollection クラスのメソッドを使用して特定の文書にナビゲートできます。

注: パフォーマンスを向上させるために、NotesDocument オブジェクトは RAM にキャッシュされます。作業が完了したら、Delete ステートメントを使用してこれらをキャッシュから削除し、メモリを復旧してください。

文書を作成、変更、削除した後は、Save メソッドを呼び出して変更を保存する必要があります。

Save を呼び出す前にスクリプトを終了させた場合、NotesDocument に加えた変更はすべて失われます。変更を保存するときは、常に Save を呼び出します。

Save を呼び出すと、文書に何もアイテムを追加していない場合でも文書はディスクに保存されます。

すでに説明したプロパティに加えて、アイテム名も NotesDocument オブジェクトのプロパティとして扱えます。例えば、次のスクリプト行は文書の Subject アイテムの値を「Hello」に設定します。

doc.Subject = "Hello"

詳しくは、AppendItemValue メソッド、ReplaceItemValue メソッドを参照してください。

スクリプトは NotesDocument のプロパティかメソッドの 1 つに初めてアクセスしたとき、暗号化された文書を解読しようとします。暗号解読に失敗したときはエラーになります。