データベースがあるコンピュータ上でエージェントを実行します。

メモ このメソッドは、R4.6.1 で新しく追加されました。

定義位置NotesAgent
構文status = notesAgent.RunOnServer( [ noteID$ ] )
パラメータnoteID$

String 型。省略可能。文書の note ID です。この値は呼び出されたエージェントの ParameterDocID プロパティに渡されます。

戻り値status

Integer 型。処理状況を返します。0 の場合は成功です。

RunOnServer メソッドを使ったエージェントを実行するためのアクセスレベルを制御する規則は、その他のサーバーで実行されるエージェントに適用されるものと同じです。エージェントのセキュリティについては、「エージェントのセキュリティを設定する」を参照してください。

ユーザーは呼び出されたエージェントと直接対話できません。ユーザーの出力は Lotus Domino log に保存されます。

呼び出されたエージェントをデバッグすることはできません。

ローカルデータベースでは RunOnServer メソッドは Run メソッドのような働きをします。つまり、ローカルコンピュータ上でエージェントを実行します。

メモ この動作は R5.0.2 の新機能です。以前は、「RunOnServer must be used with a remote database.」というエラーメッセージが表示されていました。

Lotus Notes Client で RunOnServer を呼び出すと、セキュリティはエージェントを最後に保存したユーザーのセキュリティになります。

COM アプリケーションの場合、Lotus Notes のプログラムディレクトリは COM のアプリケーションパス内に含まれていなければなりません。

クロスリファレンスJava Agent クラスの runOnServer
式言語の AgentSetServerName @コマンド

例
関連項目

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

用語集