Process activity

4D v20 R7

Process activity


Process activity {( {sessionID}{;}{options} )} -> 戻り値

引数	型	説明
sessionID	テキスト	Session ID
options	倍長整数	返されるオプション
戻り値	オブジェクト	実行中のプロセスまたはユーザーセッション(4D Serverのみ)のスナップショット

説明

Process activity コマンドは特定の時刻での、実行中のプロセス、または(4D Server のみ)接続したユーザーセッションのスナップショットを返します。このコマンドはすべてのプロセスを返し、それにはProcess info コマンドではアクセスできない内部プロセスも含まれます。

デフォルトで、引数を何も渡さずに使用した場合、Process activity は以下のプロパティを持つオブジェクトを返します:

"processes" すべてのプロセスのコレクション
"sessions" (4D Server のみ) すべてのセッションのコレクション

4D Server では、任意のsessionID および options 引数を使用することで返される情報をフィルタリングすることができます:

sessionID 引数にセッションID を渡した場合、コマンドはそのセッションに関連した情報のみを返します。デフォルトでoptions 引数が省略された場合、返されるオブジェクトには、セッションに関連したすべてのプロセスのコレクションと、セッションについて説明した1つのオブジェクトを格納したコレクションが含まれます。無効なセッションID を渡した場合、null オブジェクトが返されます。

"4D Environment" テーマの以下の定数の1つを options 引数に渡すことで、返されるコレクションを選択することができます:

定数	型	値	コメント
Processes and sessions	倍長整数	0	"processes" および "sessions" の両方のリストを返す(デフォルト値)
Processes only	倍長整数	1	プロセスの一覧のみを返します。
Sessions only	倍長整数	2	セッションの一覧のみを返します。

注意: 4D リモートまたはローカルの4D で実行された場合、Process activity は常に実行中のプロセスの一覧を返します(sessionID および options 引数は無視されます)

sessions プロパティ

"sessions" プロパティには、サーバー上で実行中の全てのセッションを説明したオブジェクトのコレクションが格納されます。

セッションオブジェクトのプロパティの説明については、Session info コマンドを参照してください

注意:

Session コマンドを使用するとセッションのオブジェクトを取得することが可能です。
Process activity はリモートクライアントセッション、ストアドプロシージャセッション、RESTセッションを返しますが、Web セッションは返しません(制約)。

processes プロパティ

"processes" プロパティには、全ての実行中のプロセスを説明したプロセスオブジェクトのコレクションが格納されています。

プロセスオブジェクトのプロパティの詳細については、Process info コマンドを参照してください。

サーバー上では、Process activity コマンドは追加で"session" プロパティも返します。

追加のプロパティ	型	詳細
session	オブジェクト	プロセスが実行中のセッションの .info プロパティ。Processes only 引数が渡されていた場合には未定義

例題 1

全てのユーザーセッションのコレクションを取得したい場合を考えます:

  //サーバー上で実行するコード

 

 var $o : Object

 var $i : Integer

 $processName;$userName Text

 

 $o:=Process activity // process と session info の両方を取得

 For($i;0;($o.processes.length)-1) // "processes" コレクション内をループ

    $processName:=$o.processes[$i].name

    $userName:=String($o.processes[$i].session.userName) // userName への簡単なアクセス

  //セッションオブジェクトが未定義の可能性があるのでString を使用すること

 End for

例題 2

You want to get all processes related to the current session:

  // to be executed on the server

 

 var $sessionID : Text:=Session.id

 var $o : Object

 

 $o:=Process activity($sessionID ;Processes only)

参照

_o_PROCESS PROPERTIES
Process info
Session storage by ID
WEB Get server info