// 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 et l'emplacement du fichier d'audit 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 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".
- 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érieuresAttention : 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é 22Attention : 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 : | |
AuditActif | L'audit dynamique est immédiatement actif. |
AuditAssertion | Les assertions sont inscrites dans l'audit dynamique. |
AuditCommentaire | Les commentaires d'audit sont inscrits dans l'audit dynamique. Un commentaire d'audit est écrit grâce à la fonction dbgEcritCommentaireAudit. |
AuditErreur | Les erreurs non fatales non traitées sont inscrites dans l'audit dynamique. |
AuditException | Les erreurs fatales, traitées par QUAND EXCEPTION ou non traitées, sont inscrites dans l'audit dynamique. |
AuditPause | L'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. |
AuditWarningAnomalie | Les warnings d'exécution concernant les anomalies détectées sont inscrits dans l'audit dynamique. |
AuditWarningPerformance | Les warnings d'exécution concernant les performances sont inscrits dans l'audit dynamique. |
AuditWarningUtilisateur | Les 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.
Divers
- La fonction dbgActiveAudit peut être utilisée dans un webservice REST.
- L'emplacement du fichier d'audit 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.