エージェントにアクセスする

NotesAgent クラスは、エージェントを表します。NotesSession の CurrentAgent プロパティを使用して、現在のエージェントにアクセスできます。このプロパティは、スクリプトがエージェントとして実行されていない場合は空になります。NotesDatabase の Agents プロパティを使用して、データベースのすべてのエージェントにアクセスできます。このプロパティはデータベースにエージェントが含まれていない場合は空になります。NotesDatabase の GetAgent メソッドを使用して、データベース中の名前付きエージェントにアクセスできます。

次の表に NotesAgent のプロパティのリストを示します。

プロパティ

データ型

説明

Comment

String

(読み込み専用) エージェントの設計者が入力したコメント。

CommonOwner

String

(読み込み専用) エージェントを最後に更新したユーザーの共通名。

HasRunSinceModified

Boolean 型

(読み込み専用) エージェントの作成後、または変更後にエージェントが実行されている場合は True。

HttpURL

String

(読み込み専用) エージェントの HTTP URL。

IsActivatable

Boolean 型

(読み込み専用) エージェントを許可するときに、ユーザーのアクティブ化が有効である場合は True。

IsEnabled

Boolean 型

(読み書き可能) エージェントを実行できる場合は True。

IsNotesAgent

Boolean 型

(読み込み専用) エージェントを Domino クライアント環境で実行できる場合は True。

IsPublic

Boolean 型

(読み込み専用) エージェントが公開エージェントの場合は True。

IsWebAgent

Boolean 型

(読み込み専用) エージェントを Web ブラウザ環境で実行できる場合は True。

LastRun

Date の Variant 型

(読み込み専用) エージェントを最後に実行した日付。

Name

String

(読み込み専用) エージェント名。

NotesURL

String

(読み込み専用) エージェントの Notes URL。

OnBehalfOf

String

(読み込み専用) 定期エージェントまたは Web エージェントが実行される ID を持つユーザー名。

Owner

String

(読み込み専用) エージェントの作成者名。

ParameterDocID

String

(読み込み専用) 文書の文書 ID。

Parent

NotesDatabase

(読み込み専用) エージェントを含むデータベース。

Query

String

(読み込み専用) エージェントが文書を選択するために使用する検索条件。

ServerName

String

(読み書き可能) エージェントを実行するサーバー名。

Target

Boolean 型または定数

(読み込み専用) エージェントが作用する文書を示します。

Trigger

Boolean 型または定数

(読み込み専用) エージェントをいつ実行するかを示します。

NotesAgent クラスには、データベースからエージェントを削除するための Remove メソッドがあります。

NotesSession の SavedData プロパティは NotesDocument オブジェクトを返します。エージェントはこの文書を使用して、起動のたびに変更されることのないデータを保存できます。しかし、エージェントが変更された場合は、保存されたデータ文書は消去されます。この文書は、親の NotesDatabase オブジェクトや NotesView オブジェクトからはアクセスできません。

Run メソッドは、現在のプログラムを実行しているコンピュータでエージェントを実行します。RunOnServer メソッドはエージェントのデータベースがあるコンピュータでエージェントを実行します。

GetPerformanceDocument メソッドは、エージェントの最新のプロファイル結果を返します。