PROCESS PROPERTIES

La commande PROCESS PROPERTIES retourne les informations sur le process dont vous passez le numéro dans process.

Après l'appel :

• procNom retourne le nom du process. Quelques points sont à noter à propos du nom du process :
  
  • Si le process a été démarré depuis la boîte de dialogue Exécuter une méthode (avec l'option Nouveau process sélectionnée), son nom est “P_” suivi d'un numéro.
  • Si le process a été démarré à partir d'une commande de menu personnalisé dont la propriété Démarrer un process est sélectionnée, le nom du process est “M_” ou “ML_” suivi d'un numéro.
  • Si le process a été démarré par le serveur Web, son nom est "Web Process#" suivi d'un identifiant UUID.
  • Si un process a été stoppé (et son “espace” non encore réutilisé), son nom est encore retourné. Pour détecter si un process est stoppé, testez procStatut=-1 (voir ci-dessous).

• procStatut retourne le statut du process au moment de l'appel. Ce paramètre peut retourner l'une des valeurs fournies par les constantes prédéfinies suivantes (thème Statut du process) :
  

  Constante	Type	Valeur
  Détruit	Entier long	-1
  Dialogue caché	Entier long	6
  En attente drapeau interne	Entier long	4
  En attente entrée sortie	Entier long	3
  En attente événement	Entier long	2
  En exécution	Entier long	0
  Endormi	Entier long	1
  Inexistant	Entier long	-100
  Suspendu	Entier long	5

• procTemps retourne le cumul du temps que le process a utilisé depuis qu'il a été démarré, en ticks (1/60e de seconde).

• procVisible, s'il est spécifié, retourne VRAI si le process est visible, FAUX s'il est caché.
• uniqueID, s'il est spécifié, retourne le numéro unique du process. En effet, chaque process se voit attribuer un numéro de process ainsi qu’un numéro unique de process par session. Ce dernier permet de différencier strictement deux process ou sessions de process. Il correspond au nombre de process ayant été lancés au cours de la session de l’application 4D.
• origine, s'il est spécifié, retourne une valeur décrivant l’origine du process. Ce paramètre peut retourner l'une des valeurs fournies par les constantes prédéfinies suivantes (thème Type du process) :
  

  Constante	Type	Valeur
  _o_Process Web avec contexte	Entier long	-11
  Aucun	Entier long	0
  Autre process 4D	Entier long	-10
  Autre process utilisateur	Entier long	4
  Créé par commande de menu	Entier long	2
  Créé par dialogue d'exécution	Entier long	3
  Gestionnaire Apple Event	Entier long	-7
  Gestionnaire d’événement	Entier long	-8
  Gestionnaire d’index	Entier long	-5
  Gestionnaire du cache	Entier long	-4
  Gestionnaire du port série	Entier long	-6
  Process 4D Server interne	Entier long	-18
  Process CSM	Entier long	-22
  Process d'activité	Entier long	-26
  Process de restitution	Entier long	-21
  Process de sauvegarde	Entier long	-19
  Process développement	Entier long	-2
  Process du fichier d'historique	Entier long	-20
  Process du serveur Web	Entier long	-13
  Process exécuté sur client	Entier long	-14
  Process exécuté sur serveur	Entier long	1
  Process exécution méthode SQL	Entier long	-24
  Process gestionnaire de clients	Entier long	-31
  Process interface serveur	Entier long	-15
  Process macro éditeur de méthod	Entier long	-17
  Process minuteur interne	Entier long	-25
  Process principal	Entier long	-1
  Process sur fermeture	Entier long	-16
  Process Web 4D distant	Entier long	-12
  Process Web sans contexte	Entier long	-3
  Tâche externe	Entier long	-9

Note : Les process internes à 4D retournent une valeur négative et les process générés par l’utilisateur retournent une valeur positive.

Si le process n'existe pas, ce qui veut dire que vous n'avez pas passé un nombre inclus dans l'intervalle [1>Count tasks], PROCESS PROPERTIES laisse les valeurs des variables passées en paramètres inchangées.

L'exemple suivant retourne le nom, le statut, et le temps écoulé dans les variables vNom, vStatut, et vTempsPassé pour le process courant :

Voir l'exemple de la section On Exit database method.