PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Fonctionnement de l'audit dynamique
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
dbgActiveAudit (Fonction)
En anglais : dbgEnableAudit
Active l'audit dynamique par programmation.
Le rapport de l'audit dynamique est un fichier ".waudit" contenant les comportements erronés ou anormaux, les opérations consommatrices de temps, ... Par exemple :
  • les assertions même si elles ne sont pas actives.
  • les erreurs non fatales non traitées.
  • les erreurs fatales (exceptions), qu'elles soient traitées par QUAND EXCEPTION ou pas.
  • les warnings d'exécution concernant des anomalies du projet (dépassement de capacité d'une variable, ...).
  • les warnings d'exécution concernant des problèmes de performances (ressources cherchées sur un réseau et non trouvées, ...).
  • les commentaires et les warnings d'exécution personnalisés.
Remarque : Si le projet correspondant à l'audit dynamique est ouvert sous l'éditeur, le fichier d'audit pourra être ouvert directement sous l'éditeur :
  • soit par l'option "Fichier .. Ouvrir" et en sélectionnant le fichier ".waudit" voulu.soit sous le volet "Accueil", dans le groupe "Général", déroulez "Ouvrir", sélectionnez "Ouvrir" et sélectionnez le fichier ".waudit" voulu.
  • soit en effectuant un "Drag and Drop" du fichier ".waudit" de l'explorateur de fichiers vers l'éditeur.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// Active l'audit dynamique avec toutes les options activées
dbgActiveAudit()
Syntaxe
<Résultat> = dbgActiveAudit([<Nom du fichier d'audit> [, <Options>]])
<Résultat> : Booléen
  • Vrai si l'audit dynamique a démarré,
  • Faux dans le cas contraire.
<Nom du fichier d'audit> : Chaîne de caractères optionnelle
Emplacement et nom du fichier d'audit à créer. Le nom du fichier d'audit 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 de l'audit d'exécution (format AAAAMMJJ).
[%Heure%]Heure de lancement de l'audit d'exécution (format HHMMSS).
[%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 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.
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.
Par défaut :
  • l'extension du fichier d'audit est ".wdaudit".
  • avant la version 180062 : le nom du fichier d'audit correspond à : "[%RepExe%][%NomExe%]_[%Date%]_[%Heure%]".
    Par exemple : "C:\MonAppli\MonAppli_20071023_130812.waudit".
  • à partir de la version 180062 : le nom du fichier d'audit correspond à : "[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]".
    Par exemple : "C:\Users\Doc\AppData\Roaming\Applications WinDev\MonAppli\MonAppli_20071023_130812.waudit".
Par défaut :
  • l'extension du fichier d'audit est ".wdaudit".
  • le nom du fichier d'audit correspond à : "[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]".
    Par exemple : "C:\Users\Doc\AppData\Roaming\Applications WinDev\MonAppli\MonAppli_20071023_130812.waudit".
Versions 22 et supérieures
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 :
dbgActiveAudit("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
devient
dbgActiveAudit(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
Nouveauté 22
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 :
dbgActiveAudit("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
devient
dbgActiveAudit(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
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 :
dbgActiveAudit("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
devient
dbgActiveAudit(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
<Options> : Constante ou combinaison de constantes optionnelle de type Entier
Permet de paramétrer les options de l'audit dynamique :
AuditActifL'audit dynamique est immédiatement actif.
AuditAssertionLes assertions sont inscrites dans l'audit dynamique.
AuditCommentaireLes commentaires d'audit sont inscrits dans l'audit dynamique. Un commentaire d'audit est écrit grâce à la fonction dbgEcritCommentaireAudit.
AuditErreurLes erreurs non fatales non traitées sont inscrites dans l'audit dynamique.
AuditExceptionLes erreurs fatales, traitées par QUAND EXCEPTION ou non traitées, sont inscrites dans l'audit dynamique.
AuditPauseL'audit dynamique est initialisé mais n'est pas immédiatement actif. Il pourra être activé ultérieurement grâce à la fonction dbgEtatAudit.
AuditTout
(Valeur par défaut)
Tous les événements d'audit sont inscrits dans l'audit dynamique.
AuditWarningAnomalieLes warnings d'exécution concernant les anomalies détectées sont inscrits dans l'audit dynamique.
AuditWarningPerformanceLes warnings d'exécution concernant les performances sont inscrits dans l'audit dynamique.
AuditWarningUtilisateurLes warnings d'exécution personnalisés sont inscrits dans l'audit dynamique. Un warning personnalisé est déclenché grâce à la fonction dbgEcritWarningAudit.
Remarques

Fonctionnement de l'audit dynamique

  • La fonction dbgActiveAudit ne doit être appelée qu'une seule fois. Tout autre appel à cette fonction sera sans effet.
  • Pour activer ou désactiver momentanément l'audit dynamique, utilisez la fonction dbgEtatAudit.
  • Pour modifier les options de l'audit dynamique, utilisez la fonction dbgOptionAudit.
WINDEVWindows Mobile Remarque :
L'audit dynamique peut être également démarré grâce au fichier ".wx" placé à côté de l'exécutable. Pour plus de détails, consultez Audit dynamique.
Composante : wd240vm.dll
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire