読み取り専用。エージェントを開始したときメモリ内にある文書です。
「新規メールの受信前」にアクティブになったエージェントの場合、 メモリ内の文書は、配信する予定のメールです。エージェントは、各メールがメールデータベースに保存されようとすると即座にアクティブになるため、エージェントを実行するたびに未保存文書を 1 つ処理することになります。AgentContext の UnprocessedDocuments プロパティは、このエージェントの種類に対しては文書を返しません。
OpenAgent URL コマンドを使用してブラウザから実行したエージェントの場合、メモリ内の文書は、Domino® によりサポートされている CGI (コモンゲートウェイインターフェース) 変数ごとにアイテムがある新規文書です。各アイテムには、サポートされている CGI 変数の名前と現在の値があります。 (お客様側での設計作業は必要ありません。CGI 変数は自動的に使用可能になります。) @Command([RunAgent]) または @Command[ToolsRunMacro] を使用してブラウザから実行したエージェントの場合、メモリ内の文書は現在の文書です。 WebQueryOpen の場合は、Domino によって HTML に変換され、ブラウザに送られる前の文書です。WebQuerySave の場合は、Domino によって保存される前の文書です。文書の基本となっているフォームに、Domino によってサポートされている CGI 変数と同じ名前のフィールドがある場合は、メモリ内の文書にもその変数の値が含まれます。 (CGI 変数はフォーム内に明示的に設計する必要があります。例えば、隠しフィールドとして設計します。)Domino でサポートされる CGI 変数のリストについては、Domino Designer 資料の「アプリケーションの設計」にある「CGI 変数名のリスト」を参照してください。
スケジュールされたエージェント、メール受信前、メール到着後、Domino サーバーで実行されていて Web ブラウザから呼び出されないエージェントの場合、現在の文書はないため、このプロパティは何も返しません。 このようなエージェントには、代わりに UnprocessedDocuments を使用します。
外部プログラムは、C API または C++ API を介してメモリ内の文書を作成し、その後エージェントを実行できます。 エージェントは、このプロパティを使用してメモリ内の文書にアクセスできます。
save メソッドは、DocumentContext によって返される Document オブジェクトで表された文書を即座に更新します。 Notes クライアントで選択した文書を処理するエージェントの場合、変更内容を保持するためには、終了前に保存する必要があります。ブラウザから呼び出されたエージェントの場合は、エージェントが終了すると、すべての変更内容がブラウザに戻ります。多くの場合、終了前の保存は望ましくありませんが、ブラウザが変更内容を処理するようにします。
getDocumentContext によって返された Document オブジェクトでは、encrypt メソッドと remove メソッドを使用できません。また、getDocumentContext によって返された Document オブジェクトを包含している Database オブジェクトでは、compact メソッドを使用できません。
Java™ Session クラスの DocumentContext プロパティ