JAVA/CORBA クラス

unprocessedSearch メソッド
例

選択条件が指定されると、データベース内の次の文書を返します。


定義が行われるクラス
AgentContext 型

構文
public DocumentCollection unprocessedSearch(String formula, DateTime limit, int maxdocs)
throws NotesException

パラメータ
String formula


DateTime limit
int maxdocs
戻り値
DocumentCollection
使用法
このメソッドはエージェントだけに有効です。

動作方法
このメソッドは、次の 2 段階で動作します。


たとえば、ビュー内のすべての選択文書を対象に実行されるエージェントの場合、unprocessedSearch は選択された文書だけを検索して、検索条件に一致する文書を返します。前回の実行以降に作成または変更された文書を対象とするエージェントの場合、unprocessedSearch は updateProcessedDoc でマークされていない文書だけを検索し、検索条件に一致する文書を返します。

返される文書
次の表に、unprocessedSearch によって返される文書を示します。エージェントの実行前に、1 度文書が選択されます。
エージェントの実行対象unprocessedSearch によって返される文書が満たすべき要件
データベースのすべての文書[エージェントのプロパティ] ボックスで指定された検索条件に一致すること

このメソッドで指定された式検索条件に一致すること

このメソッドで指定された切り離し日に一致すること

作成または変更されたすべての文書このエージェントが updateProcessedDoc を使って処理していないこと

エージェントが最後に実行されてから新規作成または更新されていること

[エージェントのプロパティ] ボックスで指定された検索条件に一致すること

このメソッドで指定された式検索条件に一致すること

このメソッドで指定された切り離し日に一致すること

ビューのすべての未読文書開かれておらず、ビューに存在すること

[エージェントのプロパティ] ボックスで指定された検索条件に一致すること

このメソッドで指定された式検索条件に一致すること

このメソッドで指定された切り離し日に一致すること

ビューのすべての文書ビューに存在すること

[エージェントのプロパティ] ボックスで指定された検索条件に一致すること

このメソッドで指定された式検索条件に一致すること

このメソッドで指定された切り離し日に一致すること

すべての選択文書ビューで選択されていること

[エージェントのプロパティ] ボックスで指定された検索条件に一致すること

このメソッドで指定された式検索条件に一致すること

このメソッドで指定された切り離し日に一致すること

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

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

他のすべてのエージェントとビューアクションでは、UpdateProcessedDoc は無効となります。

クロスリファレンス
LotusScript NotesDatabase クラスの UnprocessedSearch メソッド

式言語の EditSelectByDate @コマンド

例
関連項目