runOnServer (NotesAgent - JavaScript)

データベースを格納しているコンピュータ上でエージェントを実行します。

定義場所

NotesAgent

構文

runOnServer() : int

runOnServer(noteID:string) : int

パラメータ 説明
noteID オプション。文書の文書 ID。この値は呼び出し先エージェントの ParameterDocID プロパティに渡されます。
注: このパラメータはリリース 5.02 での新機能です。
戻り値 説明
int 操作のステータス。0 は正常な実行を表します。

使用法

このメソッドでは、ソース言語 (シンプルアクション、式、LotusScript®、Java™) に関係なく、任意のエージェントを実行できます。

エージェントを再帰的に実行することはできません (エージェントをそれ自体から呼び出すことはできません)。

このメソッドを使用してエージェントを実行するために必要なアクセスレベルを規定する規則は、他のサーバーベースエージェントの場合と同じです。エージェントのセキュリティについては、「Setting up agent security (エージェントのセキュリティの設定)」を参照してください。

ユーザーは呼び出し先エージェントと直接対話することはできません。 ユーザー出力は Domino® ログに送られます。

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

ローカルデータベースでは、このメソッドは run メソッドと同様に機能します。つまり、ローカルコンピュータ上のエージェントや、リモート (IIOP) 呼び出しを処理するサーバーを実行します。

注: メモ: この動作はリリース 5.0.2 での新機能です。 以前の動作では、"runOnServer must be used with a remote database." というエラーメッセージが表示されました。 Notes® クライアントがこのメソッドを呼び出すと、エージェントの署名者がセキュリティに関与することになります。

言語間の参照

LotusScript NotesAgent クラスの RunOnServer メソッド

Java Agent クラスの runOnServer メソッド