Process activity

4D v20 R7

Process activity


Process activity {( {sessionID}{;}{options} )} -> Résultat

Paramètre	Type	Description
sessionID	Texte	Session ID
options	Entier long	Options de retour
Résultat	Objet	Aperçu des process en cours d'exécution et/ou (4D Server uniquement) des sessions utilisateur

Description

La commande Process activity retourne une vue instantanée des processus en cours et/ou (4D Server uniquement) des sessions utilisateur connectées à un instant précis. Cette commande retourne tous les process, y compris les process internes qui ne sont pas accessibles à la commande Process info.

Par défaut, lorsqu'il est utilisé sans aucun paramètre, Process activity retourne un objet contenant les propriétés suivantes :

"processes", une collection de tous les process
"sessions" (4D Server uniquement), une collection de toutes les sessions

Sur 4D Server, vous pouvez filtrer les informations à retourner en utilisant les paramètres facultatifs sessionID et options :

Si vous passez un ID de session utilisateur dans le paramètre sessionID, la commande ne retourne que les informations relatives à cette session. Par défaut, si le paramètre options est omis, l'objet retourné contient une collection avec tous les process liés à la session et une collection avec un seul objet décrivant la session. Si vous passez un identifiant de session non valide, un objet null est retourné.

Vous pouvez sélectionner la ou les collections à retourner en passant une des constantes suivantes du thème "Environnement 4D" dans le paramètre options :

Constante	Type	Valeur	Comment
Processes and sessions	Entier long	0	Retourne les listes "process" et "sessions" (valeur par défaut)
Processes only	Entier long	1	Retourne uniquement la liste des process
Sessions only	Entier long	2	Retourne uniquement la liste des sessions utilisateurs

Note : lorsqu'elle est exécutée sur 4D en mode local ou distant, Process activity retourne toujours la liste des process en cours d'exécution (les paramètres sessionID et options sont ignorés).

Liste des sessions

La propriété "sessions" contient une collection d'objets décrivant toutes les sessions en cours sur le serveur.

Pour une description des propriétés de l'objet session, veuillez vous référer à la commande Session info.

Notes :

Vous pouvez obtenir l'objet d'une session à l'aide de la commande Session.
La commande Process activity retourne les sessions de clients distants, les sessions de procédures stockées et les sessions de repos, mais pas les sessions Web (limitation).

Liste des process

La propriété "processes" contient une collection d'objets de process décrivant tous les processus en cours.

Pour une description des propriétés des objets de process, veuillez vous référer à la commande Process info.

Sur le serveur, la commande Process activity retourne une propriété additionnelle "session" :

Propriété additionnelle	Type	Description
session	Objet	La propriété .info de la session dans laquelle le process s'exécute. Indéfini si le paramètre Processes only est passé.

Exemple 1

Vous souhaitez obtenir la collection de toutes les sessions utilisateurs :

  //A exécuter sur le serveur

 

 var $o : Object

 var $i : Integer

 $processName;$userName Text

 

 $o:=Process activity //Lire informations de process et de sessions

 For($i;0;($o.processes.length)-1) //itération de la collection "processes"

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

    $userName:=String($o.processes[$i].session.userName) // Accès facile à userName

  //utiliser String car l'objet session peut être non défini

 End for

Exemple 2

Vous souhaitez obtenir tous les processus liés à la session en cours :

  // A exécuter sur le serveur

 

 var $sessionID : Text:=Session.id

 var $o : Object

 

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

Voir aussi

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