PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Mise en place
  • Activation du log d'exécution
  • Activation directement dans l'application par programmation
  • Activation sans modifier l'application, grâce à un fichier spécifique
  • Conseils d'utilisation
  • Visualisation du log d'exécution
  • Les informations affichées dans la fenêtre des logs d'exécution sont les suivantes :
  • Compatibilité avec les versions précédentes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation
Comment connaître les fonctionnalités de l'application les plus utilisées ? Il suffit d'utiliser le log d'exécution. Le log d'exécution est une trace d'exécution. Ce log est un simple fichier (extension wlog) qui contient le détail de toutes les manipulations effectuées par un utilisateur sur une application WINDEV, WINDEV Mobile ou un site WEBDEV :
  • détail des traitements appelés,
  • fonctions du WLangage avec leurs paramètres,
  • procédures utilisateur avec leurs paramètres,
  • threads,
  • composants.
Ce fichier permet par exemple de :
  • connaître les manipulations les plus utilisées dans l'application.
  • connaître les traitements prenant le plus de temps.
  • suivre le code exécuté lors d'un traitement posant problème (difficile à isoler en mode test).
L'équipe de développement connaît ainsi les parties de l'application les plus utilisées, et peut focaliser ses ressources sur des parties de code à optimiser.
Mise en place

Activation du log d'exécution

L'activation du log d'exécution peut être réalisée :
  • directement dans l'application, par programmation.
  • WINDEV sans modifier l'application, grâce à un fichier spécifique

Activation directement dans l'application par programmation

Cette activation est réalisée grâce à la fonction dbgActiveLog. Différentes fonctions WLangage permettent de gérer le log d'exécution :
dbgActiveLogActive la gestion du log d'exécution.
dbgEtatLogPermet de connaître et modifier l'état du log d'exécution (actif, inactif, en pause).
dbgOptionLogPermet de connaître et de modifier les options du log d'exécution.
WINDEV

Activation sans modifier l'application, grâce à un fichier spécifique

Il suffit de créer un fichier <Nom Exécutable>.WX à côté de l'exécutable de l'application. Ce fichier doit contenir les lignes suivantes :
[LOG]
Actif=<0/1>
Fichier=<Nom du fichier WXLOG>
Option=<Valeur des options>
Détaillons ces lignes :
  • Actif : Ce paramètre doit correspondre à 0 pour désactiver le log et 1 pour l'activer.
  • Fichier : Nom du fichier de log (fichier d'extension "wlog"). Ce nom peut être construit avec les éléments suivants :
    [%RepExe%]Répertoire de l'exécutable, toujours complété par le caractère "\". Ce répertoire est équivalent au résultat de la fonction fRepExe.
    [%NomExe%]Nom de l'exécutable.
    [%Date%]Date de lancement du fichier Log.
    [%Heure%]Heure de lancement du fichier Log.
    [%NomUtilisateur%]Nom de l'utilisateur courant.
    [%NomMachine%]Nom de la machine.
    Versions 18 et supérieures
    [%RepDonnees%]
    Nouveauté 18
    [%RepDonnees%]
    [%RepDonnees%]
    Répertoire des fichiers de données HyperFileSQL spécifié par l'utilisateur lors de l'installation de l'application. Ce répertoire est équivalent au résultat de la fonction fRepDonnées.
    Versions 18 et supérieures
    [%RepDonneesUtilisateur%]
    Nouveauté 18
    [%RepDonneesUtilisateur%]
    [%RepDonneesUtilisateur%]
    Répertoire pour les données de l'utilisateur courant de l'application courante. Ce répertoire est équivalent au résultat de la fonction fRepDonnéesUtilisateur.
  • Option : Options du fichier de log.
    • Si les options ne sont pas spécifiées dans le fichier WX (la ligne OPTION n'est pas présente), le fichier de log est créé avec les options par défaut : seules les fonctions WLangage sont présentes dans le fichier de log.
    • "" (chaîne vide) : Seuls les traitements sont mémorisés dans le log.
    • "*" : le log contient toutes les informations.
    • une combinaison de valeurs :
      • "+F" pour activer la trace des fonctions,
      • "+P" pour activer la trace des paramètres.

Conseils d'utilisation

Selon la finalité du log d'exécution, sa mise en place peut différer ainsi que les options choisies :
  • Pour connaître les options les plus utilisées d'une application, il est conseillé d'utiliser un log d'exécution le plus simple possible (sans détail des fonctions appelées). En effet, plus le nombre d'options demandées est important, plus la taille du log d'exécution sera importante.
    WINDEV Le log peut être mis en place avec le fichier .WX.
  • Pour tracer un problème difficilement reproductible, il est conseillé d'utiliser les fonctions WLangage pour mettre en place le log d'exécution. Le log d'exécution sera activé au début de la partie posant problème.
Visualisation du log d'exécution
Le log d'exécution peut être visualisé sous l'éditeur de WINDEV, WEBDEV ou WINDEV Mobile :
  • soit en faisant un "Drag and Drop" du fichier ".wlog" vers l'éditeur de fenêtres (par exemple sur la barre des documents ouverts).
  • soit directement en ouvrant le fichier ".wlog" (option "Fichier .. Ouvrir").soit directement en ouvrant le fichier ".wlog".
    Rappel : Pour ouvrir un fichier depuis l'éditeur, sous le volet "Accueil", dans le groupe "Général", déroulez "Ouvrir" et sélectionnez le fichier voulu.
Pour visualiser le log d'exécution, le projet en cours sous l'éditeur doit être le projet de l'application ou le projet d'un des composants utilisé par l'application. Seules les informations concernant le projet en cours seront affichées.

Les informations affichées dans la fenêtre des logs d'exécution sont les suivantes :

  • Les informations générales sur le fichier de log : nom, application, date et heure de lancement, date et heure de fin.
  • Les éléments les plus utilisés : trois onglets sont affichés :
    • Statistiques des éléments : Permet de voir les éléments les plus utilisés de votre projet, avec le temps d'utilisation et le nombre de traitements effectués. La sélection d'un élément permet de :
      - voir les endroits depuis lesquels l'élément est utilisé (dans la partie basse de l'écran)
      - voir l'élément dans l'éditeur (bouton "Voir l'élément")
      - accéder aux statistiques de traitements (bouton "Statistiques des traitements").
    • Statistiques des traitements : Permet d'obtenir des statistiques sur le temps de chaque traitement. Il est également possible de filtrer les informations sur un élément spécifique du projet.
      En bas de l'écran, la raison de l'appel est affichée (action utilisateur, ...). Pour l'élément sélectionné, il est possible de visualiser l'enchaînement des appels (bouton "Enchaînement des appels").
      Le bouton "Voir le code du traitement" permet d'afficher le code WLangage correspondant sous l'éditeur de code. Attention, la fenêtre d'affichage des logs est toujours positionnée au premier plan.
    • Enchaînement des appels : Permet de visualiser l'enchaînement des traitements réalisés dans le code sélectionné. Le détail des fonctions manipulées est affiché.
      En bas de l'écran, des informations supplémentaires peuvent être affichées : Paramètres de la procédure, résultat, ...
      Le bouton "Voir le code de l'appel" permet d'afficher le code appelant. Le bouton "Recentrer sur traitement" permet de visualiser le code du traitement en cours.
  • Les appels des procédures et des fonctions WLangage : Permet de voir tous les appels aux procédures et fonctions WLangage.
    En bas de l'écran, des informations supplémentaires peuvent être affichées : Paramètres de la procédure, résultat, ...
    Le bouton "Voir le code du traitement" permet d'afficher le code WLangage correspondant sous l'éditeur de code. Attention, la fenêtre d'affichage des logs est toujours positionnée au premier plan.
  • Les interactions entre les threads : Permet de sélectionner le thread à considérer et de visualiser l'enchaînement des appels pour chaque thread.

Compatibilité avec les versions précédentes

Attention : Les logs d'exécution créés avec la version 120034D ne peuvent plus être ouverts : ils doivent être re-créés pour être visualisés correctement.
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire