LOTUSSCRIPT /COM/OLE のクラス

UnprocessedSearch メソッド
例

文書の検索条件を指定すると、データベース内の次の文書を返します。


メモ このメソッドは COM では実装されていません。

定義位置
NotesDatabase 型

構文
Set notesDocumentCollection = notesDatabase.UnprocessedSearch( formula$, notesDateTime, maxDocs% )

パラメータ
formula$


notesDateTime
maxDocs%
戻り値
notesDocumentCollection
使い方
このメソッドはエージェントまたはビューアクションスクリプトに対してのみ有効で、NotesSession の CurrentDatabase プロパティから取得した NotesDatabase オブジェクトだけで起動できます。エージェントまたはビューアクションに含まれないスクリプトでは、このメソッドは文書が 1 つも入っていない NotesDocumentCollection を返します。CurrentDatabase プロパティから取得されていない NotesDatabase オブジェクトで呼び出されたときは、このメソッドはエラーとなります。

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


たとえば、ビューのすべての選択文書を対象に実行されるエージェントの場合、UnprocessedSearch は選択文書だけを検索して、条件に一致する文書を返します。前回の実行以降に作成または変更された文書を対象とするエージェントの場合、UnprocessedSearch は NotesSession の UpdateProcessedDoc メソッドが処理済みのマークを付けていない文書だけを検索して、条件と一致する文書を返します。

返される文書
次の表は UnprocessedSearch メソッドが返す文書を示します。エージェントを実行する前に文書が 1 回選択されます。
エージェントの実行対象UnprocessedSearch によって返される文書が満たさなければならないすべての条件
データベースのすべての文書[エージェントのプロパティ] インフォボックスで指定された検索条件を満たすこと

このメソッドで指定された @関数の検索条件を満たすこと

すべての新規作成または更新された文書このエージェントが UpdateProcessedDoc で処理していないこと

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

[エージェントのプロパティ] インフォボックスで指定された検索条件を満たすこと

このメソッドで指定された @関数の検索条件を満たすこと

ビューのすべての未読文書ビューにある未読文書

[エージェントのプロパティ] インフォボックスで指定された検索条件を満たすこと

このメソッドで指定された @関数の検索条件を満たすこと

ビューのすべての文書ビューにある文書

[エージェントのプロパティ] インフォボックスで指定された検索条件を満たすこと

このメソッドで指定された @関数の検索条件を満たすこと

選択されたすべての文書

または

ビューアクション

ビューで選択されている文書

[エージェントのプロパティ] インフォボックスで指定された検索条件を満たすこと

このメソッドで指定された @関数の検索条件を満たすこと

なし現在の文書のみ
新規に受信したメール文書エージェントの最終実行後にデータベースに送信されたこと

[エージェントのプロパティ] インフォボックスで指定された検索条件を満たすこと

このメソッドで指定された @関数の検索条件を満たすこと

新規に更新された文書エージェントの最終実行後に更新されたこと

[エージェントのプロパティ] インフォボックスで指定された検索条件を満たすこと

このメソッドで指定された @関数の検索条件を満たすこと

追加された文書エージェントの最終実行後にデータベースに追加されたこと

[エージェントのプロパティ] インフォボックスで指定された検索条件を満たすこと

このメソッドで指定された @関数の検索条件を満たすこと

UpdateProcessedDoc の使い方
新規作成および変更された文書、新規に受信したメール文書、新規に追加された文書、新規に変更された文書で実行されるエージェントの場合、NotesSession の UpdateProcessedDoc メソッドを使って、各文書を「処理済み」にします。「処理済み」にすると、再び変更、メール送信、追加をされないかぎり、エージェントはその文書を処理しません。各文書についてこのメソッドを呼び出さないときは、エージェントは次の実行で同じ文書を処理してしまいます。

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

UpdateProcessedDoc は他のすべてのエージェントとビューアクションに影響を与えません。

ビューアクション
ビューアクションで使われるとき、UnprocessedSearch は選択文書で実行されるエージェントの場合と同じ文書を返します。

クロスリファレンス
Java AgentContext クラスの unprocessedSearch メソッド

式言語の EditSelectByDate @コマンド

例
関連項目