読み込み専用。データベース内にあり、現在のエージェントが「未処理」であるとみなす文書です。エージェントの種類によって、未処理とみなされる文書が決まります。

定義が行われるクラス
AgentContext

データ型
DocumentCollection

構文
public DocumentCollection getUnprocessedDocuments()
throws NotesException

使用法
このメソッドはエージェントだけに有効です。

返される文書
次の表に、getUnprocessedDocuments によって返される文書を示します。エージェントの実行前に、1 度文書が選択されます。

エージェントの実行対象	UnprocessedDocuments によって返される文書が満たすべき要件
データベースのすべての文書	[エージェントのプロパティ] ボックスで指定された検索条件に一致すること
作成または変更されたすべての文書	このエージェントが updateProcessedDoc を使って処理していないこと エージェントが最後に実行されてから新規作成または更新されていること [エージェントのプロパティ] ボックスで指定された検索条件に一致すること
ビューのすべての未読文書	開かれておらず、ビューに存在すること [エージェントのプロパティ] ボックスで指定された検索条件に一致すること
ビューのすべての文書	ビューに存在すること [エージェントのプロパティ] ボックスで指定された検索条件に一致すること
すべての選択文書	ビューで選択されていること [エージェントのプロパティ] ボックスで指定された検索条件に一致すること
なし	現在の文書であること

UpdateProcessedDoc の使い方
新規作成および変更された文書で実行されるエージェントの場合、Session の updateProcessedDoc を使って各文書を「処理済み」としてマークする必要があります。これによって、文書がエージェントから (再度変更されない限り) 1 度しか処理されないことが保証されます。各文書に対してこのメソッドを呼び出さないと、エージェントは次に実行されたときに同じ文書を処理します。

updateProcessedDoc メソッドは、メソッドの呼び出し元の特定のエージェントに対してのみ、文書を処理済みとしてマークします。あるエージェントで updateProcessedDoc を使っても、別のエージェントが処理する文書には影響ありません。

クロスリファレンス
LotusScript NotesDatabase クラスの UnprocessedDocuments プロパティ

式言語の @All 関数

例
関連項目

エージェントにアクセスする
すべての文書とすべての未処理文書を収集する