LIRE APERCU ACTIVITE

La commande LIRE APERCU ACTIVITE retourne un ou plusieurs tableau(x) décrivant les opérations en cours de progression sur les données de 4D. Ces opérations entraînent généralement l’affichage d’une fenêtre de progression. 

Cette commande permet d’obtenir un instantané des n opérations les plus coûteuses en temps et/ou les plus fréquentes en cours d’exécution telles que l’écriture du cache ou l’exécution de formules.

Note : Les informations retournées par la commande LIRE APERCU ACTIVITE sont les mêmes que celles affichées dans la page "Moniteur temps réel" (MTR) de la fenêtre d’administration de 4D Server (cf. guide de référence de 4D Server).

Par défaut, LIRE APERCU ACTIVITE traite des opérations effectuées en local (avec 4D monoposte, 4D Server ou 4D en mode distant). Avec 4D en mode distant cependant, vous pouvez également obtenir l’aperçu des opérations effectuées sur le serveur : il suffit pour cela de passer l’étoile (*) en dernier paramètre. Dans ce cas, les données du serveur seront récupérées localement. Le paramètre * est ignoré lorsque la commande est exécutée sur 4D Server ou 4D monoposte. 

La commande LIRE APERCU ACTIVITE admet deux syntaxes :

• syntaxe utilisant uniquement un tableau objet.
• syntaxe utilisant plusieurs tableaux.

Avec cette syntaxe, toutes les opérations sont retournées sous forme structurée dans le tableau d’objets 4D tabActivités. Chaque élément du tableau est un objet construit de la manière suivante :

Voici une description de chaque propriété retournée :

• message (texte) : libellé de l'opération
• maxValue (numérique) : nombre d'itérations prévues dans l'opération (-1 si opération non itérative)
• currentValue (numérique) : itération courante
• interruptible (numérique) : opération pouvant être interrompue par l'utilisateur (0=vrai, 1=faux)
• remote (numérique) : opération jumelée entre le client et le serveur (0=vrai, 1=faux)
• uuid (texte) : identifiant UUID de l'opération
• taskId (numérique) : identifiant interne du process à l'origine de l'opération
• startTime (texte) : horaire de démarrage de l'opération au format "aaaa:mm:jj hh:mm:ss:mls"
• duration (numérique) : durée de l'opération en millisecondes
• subOperations (tableau) : tableau d'objets contenant les sous-opérations de l'opération courante (le cas échéant). La structure de chaque sous-élément est identique à celle de l'objet principal. Si l'opération courante n'a pas de sous-opérations, subOperations est vide.

Avec cette syntaxe, toutes les opérations sont retournées sous forme de plusieurs tableaux synchronisés (chaque opération entraîne l’ajout d’un élément dans tous les tableaux). Les tableaux suivants sont retournés :

• tabUUID : contient les identifiants UUID de chaque opération (correspond à la propriété uuid de l'objet tabActivités dans la syntaxe précédente)
• tabDébut : contient les horaires de démarrage de chaque opération (correspond à la propriété startTime de l'objet tabActivités)
• tabDurée : contient les durées de chaque opération en millisecondes (correspond à la propriété duration de l'objet tabActivités)
• tabInfo : contient les libellés décrivant chaque opération (correspond à la propriété message de l'objet tabActivités)
• tabSousOp (optionnel) : chaque élément de ce tableau est un objet contenant la propriété "subOperations". La valeur de cette propriété est un tableau objet contenant toutes les sous-opérations de l’opération courante. Si l’opération courante n’a pas de sous-opérations, la valeur de la propriété subOperations est un tableau vide (correspond à la propriété subOperations de l'objet tabActivités).

Cette méthode, exécutée dans un process séparé sous 4D ou 4D Server, permet d’obtenir un instantané des opérations en progression :

Vous obtenez des tableaux du type :