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 @コマンド

例
関連項目