DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion du débogage
  • Fonctionnement du log d'exécution
  • Divers
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
dbgActiveLog (Fonction)
En anglais : dbgEnableLog
Active par programmation le log d'exécution.
Remarque : 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". Si le projet correspondant au log d'exécution est ouvert sous l'éditeur, le fichier de log pourra être ouvert directement sous l'éditeur :
  • soit sous le volet "Accueil", dans le groupe "Général", déroulez "Ouvrir", sélectionnez "Ouvrir" et sélectionnez le fichier ".wxl" voulu.
  • soit en effectuant un "Drag and Drop" du fichier ".wxl" de l'explorateur de fichiers vers l'éditeur.
Pour plus de détails, consultez Log d'exécution.
Note : Dans les versions précédentes, le log d'exécution correspondait à un fichier ".wlog".
Exemple
// Active le log d'exécution par défaut
dbgActiveLog()
Syntaxe
<Résultat> = dbgActiveLog([<Fichier Log> [, <Options> [, <Délai avant recyclage>]]])
<Résultat> : Booléen
  • Vrai si le log d'exécution a démarré,
  • Faux dans le cas contraire.
<Fichier Log> : Chaîne de caractères optionnelle
Emplacement et nom du fichier log à créer. Le nom et l'emplacement du fichier log peuvent être :
  • complètement personnalisés.
  • construits à l'aide des mots-clés 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 log d'exécution (format AAAAMMJJ).
    [%Heure%]Heure de lancement du log d'exécution (format HHMMSS).
    [%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.

Par défaut, le nom du fichier Log correspond à :
"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]".
Par exemple :
"C:\Users\Doc\AppData\Roaming\Applications WinDev\MonAppli\Monappli_20071023_130812.wlog".
Attention : Si vous utilisez la construction dynamique des chaînes (option "Autoriser "[% %]" dans les chaînes" dans l'onglet "Compilation" de la description du projet, une erreur de compilation apparaît (identificateur inconnu). Dans ce cas, il est nécessaire de faire précéder chaque chaîne par '-%'. Exemple :
dbgActiveLog("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
devient
dbgActiveLog(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
<Options> : Constante ou combinaison de constantes optionnelle de type Entier
Permet de paramétrer les options du log d'exécution :
LogActifLe log d'exécution est immédiatement actif.
LogFonctionsWLangageLes fonctions WLangage sont inscrites dans le log d'exécution.
LogParamètresLes paramètres des fonctions sont inscrits dans le log d'exécution.
LogPauseLe log d'exécution n'est pas immédiatement actif
LogToutLe log d'exécution récupère :
  • les fonctions WLangage
  • les paramètres des fonctions
  • les traitements
LogTraitementUniquementLe log d'exécution récupère uniquement les informations des traitements.

Par défaut, si ce paramètre n'est pas spécifié, la combinaison de constantes LogActif + LogFonctionsWLangage est utilisée.
<Délai avant recyclage> : Durée optionnelle
Délai (exprimé en secondes) avant suppression des anciennes informations du log afin de limiter la taille du fichier. Si ce paramètre n'est pas spécifié, les anciennes informations du log ne sont pas supprimées.
Remarques

Fonctionnement du log d'exécution

  • La fonction dbgActiveLog ne doit être appelée qu'une seule fois. Tout autre appel à cette fonction sera sans effet.
  • Pour activer / désactiver momentanément le log d'exécution, utilisez la fonction dbgEtatLog.
  • Pour modifier les options du log d'exécution, utilisez la fonction dbgOptionLog.
WINDEV Remarque : Le log d'exécution peut être également démarré grâce au fichier ".wx" placé à côté de l'exécutable. Pour plus de détails, consultez Log d'exécution.

Divers

  • La fonction dbgActiveLog peut être utilisée dans un webservice REST.
  • L'emplacement du fichier de log peut être totalement personnalisé. Dans ce cas, ne pas oublier les problèmes de droits qui peuvent se poser.
    Rappel : Le répertoire des données est normalement toujours disponible en écriture.
Composante : wd300vm.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Attention au nom de fichier en paramètre
En version 27 (77j) Si le nom de fichier contient plus que 1 point (.) le nom du fichier sera tronqué après le 2e point.
Yoda
25 fév. 2022

Dernière modification : 22/03/2024

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