Process activity
Process activity () : Object
Process activity ( options ) : Object
Process activity ( sessionID ) : Object
Process activity ( sessionID ; options ) : Object
Parámetros | Tipo | Descripción | |
---|---|---|---|
sessionID | Text | → | ID de sesión |
options | Integer | → | Opciones de retorno |
Resultado | Object | ← | Instantánea de los procesos en ejecución y/o sesiones de usuario (sólo 4D Server) |
Historia
Lanzamiento | Modificaciones |
---|---|
20 R7 | Soporte del parámetro sessionID |
21 | Soporte de sesiones usuario web |
Descripción
The Process activity command returns a snapshot of running processes and/or (4D Server only) connected user sessions at a given time.El comando Process activity devuelve una instantánea de los procesos en ejecución y/o (sólo en 4D Server) de las sesiones de usuario conectadas en un momento dado. Este comando devuelve todos los procesos, incluidos los procesos internos a los que no se puede acceder mediante el comando Process info.
Por defecto, cuando se utiliza sin ningún parámetro, Process activity devuelve un objeto que contiene las siguientes propiedades:
- "processes", una colección de todos los procesos
- "sessions" (sólo 4D Server), una colección de todas las sesiones
En 4D Server, puede filtrar la información a devolver utilizando los parámetros opcionales sessionID y options:
- Si pasa un ID de sesión usuario en el parámetro sessionID, el comando sólo devuelve información relacionada con esta sesión. Por defecto, si se omite el parámetro options, el objeto devuelto contiene una colección con todos los procesos relacionados con la sesión y una colección con un único objeto que describe la sesión. Si se pasa un ID de sesión inválido, se devuelve un objeto null.
- Puede seleccionar la(s) colección(es) a devolver pasando una de las siguientes constantes en el parámetro options:
Constante | Valor | Comentario |
---|---|---|
Processes and sessions | 0 | Devuelve las listas "processes" y "sessions" (valor por defecto) |
Processes only | 1 | Devuelve sólo la lista "processes" |
Sólo sesiones | 2 | Devuelve solo la lista "sessions" |
Cuando se ejecuta en 4D en modo remoto o local, Process activity
siempre devuelve la lista de procesos en ejecución (se ignoran los parámetros sessionID y options).
Sessions
La propiedad "sessions" contiene una colección de objetos que describen todas las sesiones en ejecución en el servidor. Para una descripción de las propiedades del objeto de sesión, por favor consulte el comando Session info
.
Puede obtener el objeto de una sesión utilizando el comando Session.
Processes
La propiedad "processes" contiene una colección de objetos de proceso que describen todos los procesos en ejecución. Para una descripción de las propiedades del objeto de proceso, por favor consulte el comando Process info
.
En el servidor, el comando Process activity
devuelve una propiedad adicional "session":
Propiedad adicional | Tipo | Descripción | |
---|---|---|---|
session | Object | La propiedad .info de la sesión en la que se está ejecutando el proceso. Undefined si se pasa el parámetro Processes only . |
Ejemplo 1
Desea obtener la colección de todas las sesiones usuario:
//A ejecutar en el servidor
var $o : Object
var $i : Integer
var $processName;$userName : Text
$o:=Process activity //Obtener información de proceso y sesión
For($i;0;($o.processes.length)-1) //Iterar sobre la colección "processes"
$processName:=$o.processes[$i].name
$userName:=String($o.processes[$i].session.userName) // Acceso fácil a userName
//Utilizar String porque el objeto session puede estar indefinido
End for
Ejemplo 2
Desea obtener todos los procesos relacionados con la sesión actual:
// a ejecutar en el servidor
var $sessionID : Text:=Session.id
var $o : Object
$o:=Process activity($sessionID ;Processes only)
Ver también
Process info
Session info
Session storage
WEB Get server info