Lire activite process

4D v20 R7


Lire activite process {( {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 Lire activite process 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 Lire info process.

Par défaut, lorsqu'il est utilisé sans aucun paramètre, Lire activite process 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
Process et sessions	Entier long	0	Retourne les listes "process" et "sessions" (valeur par défaut)
Process seulement	Entier long	1	Retourne uniquement la liste des process
Sessions seulement	Entier long	2	Retourne uniquement la liste des sessions utilisateurs

Note : lorsqu'elle est exécutée sur 4D en mode local ou distant, Lire activite process 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 Lire activite process 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 Lire info process.

Sur le serveur, la commande Lire activite process 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 Process seulement 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_INFORMATIONS PROCESS
Lire info process
Stockage de session par ID
WEB Lire infos serveur