Process activity

4D v20 R7

Process activity


Process activity {( {sessionID}{;}{opciones} )} -> Resultado

Parámetro	Tipo	Descripción
sessionID	Texto	Session ID
opciones	Entero largo	Opciones a devolver
Resultado	Objeto	Instantánea de los procesos en ejecución y/o (4D Server únicamente) de las sesiones de usuario

Descripción

El comando Process activity devuelve una instantánea de los procesos y/o (4D Server únicamente) sesiones de usuario conectados de los procesos relacionados que se ejecutan en un momento dado. Este comando devuelve todos los procesos, incluyendo los procesos internos que no son accesibles por 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 opcionalesl sessionID y opciones:

Si pasa un ID de sesión de 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 opciones, 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 no válido, se devuelve un objeto null.

Puede seleccionar la(s) colección(es) a devolver pasando una de las siguientes constantes del tema "Entorno 4D" en el parámetro opciones:

Constante	Tipo	Valor	Comentario
Processes and sessions	Entero largo	0	Devuelve las listas "process" y "sessions" (valor por defecto)
Processes only	Entero largo	1	Devuelve sólo la lista de procesos
Sessions only	Entero largo	2	Devuelve sólo la lista de sesión de usuario

Nota: cuando se ejecuta en 4D en modo remoto o local, Process activity sólo devuelve la lista de procesos en ejecución (los parámetros sessionID y opciones se ignoran).

Sesiones

La propiedad "sessions" contiene una colección de objetos que describen todas las sesiones en ejecución en el servidor.

For a description of session object properties, please refer to the Session info command.

Notas:

puede obtener el objeto de una sesión utilizando el comando Session.
Process activity devuelve sesiones de clientes remotos, sesiones de procedimientos almacenados y sesiones restantes, pero no sesiones Web (limitación).

Procesos

La propiedad "procesos" contiene una colección de objetos procesos que describen todos los procesos en ejecución.

Para obtener una descripción de las propiedades de los objetos proceso, consulte el comando Process info.

En el servidor, el comando Process activity devuelve una propiedad adicional "session":

Propiedad adicional	Tipo	Descripción
session	Objeto	La propiedad .info de la sesión en la que se está ejecutando el proceso. Indefinido si se pasa el parámetro Processes only.

Ejemplo 1

Usted quiere obtener la colección de todas las sesiones usuario:

  //A ejecutar en el servidor

 var $o : Object

 var $i : Integer

 $processName;$userName Text

 

 $o:=Process activity //Obtenga información sobre el proceso y la 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 sesión podría ser indefinido

 End for

Ejemplo 2

Desea obtener todos los procesos relacionados con la sesión actual:

  // que se ejecutarán en el servidor

 

 var $sessionID : Text:=Session.id

 var $o : Object

 

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

Ver también

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