DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Test
  • 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
  • Informations affichées
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
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 fichier 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 :
  • analyser les performances de l'application.
  • 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.
Remarque : Jusqu'à la version 27, le log d'exécution correspondait à un fichier ".wlog". A partir de la version 28, le log d'exécution est composé d'un fichier ".wxl", d'un fichier ".ndx" et d'un fichier ".mmo".
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 de log>
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. 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.
    [%RepDonnees%]Répertoire des fichiers de données HFSQL 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.
    [%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
Pour visualiser le log d'exécution :
  1. Ouvrez le projet voulu sous l'éditeur : le projet en cours 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.
  2. Ouvrez le fichier correspondant au log d'exécution sous l'éditeur de WINDEV, WEBDEV ou WINDEV Mobile :
    • soit en faisant un "Drag and Drop" du fichier ".wxl" (ou ".wlog") vers l'éditeur de fenêtres ou de pages (par exemple sur la barre des documents ouverts).
    • soit directement en ouvrant le fichier ".wxl" (ou ".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.
  3. Sélectionnez les informations à visualiser.

Informations affichées

Les informations pouvant êtres affichées à partir du log d'exécution sont les suivantes :
  • Informations générales sur le fichier de log : nom, application, date et heure de lancement, date et heure de fin.
  • Analyse des performances à partir du log d'exécution : Permet de visualiser l'activité de l'application pendant son utilisation. Le graphe affiche les périodes d'activité et de non activité via un système de paliers, les paliers hauts représentant les périodes d'activité. Pour chaque palier haut, il est possible de visualiser les procédures exécutées et le détail des fonctions WLangage utilisées.
    Pour plus de détails, consultez Analyseur Temps Réel (ATR).
  • Eléments les plus utilisés : différents 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.
  • Jounal des appels : 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.
  • Threads : Permet de sélectionner le thread à considérer et de visualiser l'enchaînement des appels pour chaque thread.
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 28/03/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale