LIRE APERCU ACTIVITE

4D v15

LIRE APERCU ACTIVITE ( tabActivités | tabUUID ; tabDébut ; tabDurée ; tabInfo {; tabDétails}{; *} )

Paramètre	Type		Description
tabActivités \| tabUUID	Tableau objet, Tableau texte	<-	Description complète des opérations (tableau objet) ou
			UUIDs des opérations (tableau texte)
tabDébut	Tableau texte	<-	Heures de démarrage des opérations
tabDurée	Tableau entier long	<-	Durées des opérations en secondes
tabInfo	Tableau texte	<-	Description
tabDétails	Tableau objet	<-	Détails du contexte et Sous-opérations (le cas échéant)
*	Opérateur	->	Si passé = Lire activité serveur

Nouvelles propriétés

Introduit dans 4D v14 R3

Cette commande retourne des informations supplémentaires, dans le cadre de l'évolution de la page "Moniteur temps réel" (MTR) de la fenêtre d'administration de 4D Server (voir Page Moniteur temps réel).

Les nouvelles informations sont retournées dans deux nouvelles propriétés : dbContextInfo et dbOperationDetails. Ces propriétés sont disponibles dans les deux syntaxes de la commande.

LIRE APERCU ACTIVITE/GET ACTIVITY SNAPSHOT(tabActivités)

Avec cette syntaxe, les nouvelles propriétés sont accessibles au premier niveau de l'objet tabActivités :

[
    {
        "message":"xxx",
        "maxValue":12321,
        "currentValue":63212,
        "interruptible:0,
        "remote":0,
        "uuid":"deadbeef",
        "taskId":xxx,
        "startTime":"2014-03-20 13:37:00:123",
        "duration":92132,
        "dbContextInfo":{
            "task_id": xxx,
            "user_name": Jean,
            "host_name": HAL,
            "task_name": "CreateIndexLocal",
            "client_uid": "DE4DB33F33F"
            "user4d_id ": 1,
            "client_version ": 123456
        },
        "dbOperationDetails":{
            table: "maTable"
            field: "Champ_1"
        },
        "subOperations":[...]
    },...
]

LIRE APERCU ACTIVITE/GET ACTIVITY SNAPSHOT(tabUUID ;tabDébut;tabDurée; tabInfo {;tabDétails}{;*})

Avec cette syntaxe, les nouvelles propriétés sont disponibles dans le dernier paramètre, rebaptisé tabDétails pour plus de clarté. La structure de ce tableau est désormais :

[
    {
        "dbContextInfo":{...} //voir ci-dessous
        "dbOperationDetails":{...} //voir ci-dessous
        "subOperations":[...]
    },...
]

Description

dbContextInfo

Cette propriété est un objet contenant des informations relatives aux opérations traitées par le moteur de base de données. Il est constitué des propriétés suivantes :

host_name (chaîne) : nom de l'hôte ayant lancé l'opération
user_name (chaîne) : nom de l'utilisateur 4D dont la session a lancé l'opération
task_name (chaîne) : nom du process ayant lancé l'opération
task_id (num) : numéro d'id du process ayant lancé l'opération
client_uid (chaîne) : optionnel, uuid du client ayant lancé l'opération
is_remote_context (booléen, 0 ou 1) : optionnel, indique si l'opération de base de données a été lancée par un client (valeur 1) ou par le serveur via une procédure stockée (valeur 0)
user4d_id (num) : numéro d'id de l'utilisateur 4D courant côté client
client_version (chaîne) : quatre chiffres représentant la version du moteur 4D de l'application, tels que retournés par la commande Version application.

client_uid et is_remote_context sont disponibles uniquement en mode client/serveur. client_uid n'est retourné que si l'opération de base de données a été démarrée sur un poste client.

dbOperationDetails

Cette propriété est retournée uniquement si l'opération fait appel au moteur de base de données (c'est le cas par exemple pour les recherches et les tris). Il s'agit d'un objet contenant des informations spécifiques liées à l'opération elle-même. Les propriétés disponibles dépendent de la nature de l'opération de base de données effectuée. Ces propriétés incluent notamment :

table (chaîne): nom de la table impliquée dans l'opération
field (chaîne): nom du champ impliqué dans l'opération
queryPlan (chaîne): plan de recherche défini pour l'opération
...