Syntaxe
|
Trace( Message [, TraceSeverity [, CustomRecord [, TraceOptions ] ] ] )
|
Paramètres
| Nom |
Description |
| Message |
Ce paramètre permet de spécifier le message à consigner dans les journaux de trace. |
| TraceSeverity |
Ce paramètre permet de définir le niveau de gravité du message (par exemple : Information, Warning, Error). |
| CustomRecord |
Ce paramètre permet de fournir un enregistrement personnalisé contenant des données supplémentaires à tracer. |
| TraceOptions |
Ce paramètre permet de spécifier des options supplémentaires pour contrôler le comportement de la trace (facultatif). |
Description
Cette fonction permet d'enregistrer des informations de débogage.
Remarques
- La fonction Trace est essentielle pour le débogage en environnement de développement : Elle permet de consigner des messages à différents niveaux de
gravité, facilitant ainsi l'identification de comportements inattendus ou d'erreurs dans les formules.
- Le paramètre Message permet de documenter clairement le contexte d'une opération : Cela aide à retracer le cheminement logique d'une exécution, surtout
lorsque plusieurs branches conditionnelles sont évaluées dans des expressions complexes.
- TraceSeverity permet de classifier l'importance des messages générés : En définissant un niveau comme Information, Warning ou Error,
il devient plus facile de filtrer et d'interpréter les messages lors d'une analyse a posteriori des traces.
- Le paramètre CustomRecord permet d'ajouter des données contextuelles utiles : Ces données personnalisées (valeurs de variables, états internes,
identifiants utilisateurs,...) enrichissent les traces et accélèrent la résolution des anomalies.
- Le paramètre TraceOptions, bien que facultatif, donne un contrôle avancé : Il permet de définir des options spécifiques (comme la fréquence
d'enregistrement ou la limitation du volume), ce qui est utile pour éviter une surcharge des journaux.
- Trace est très utile dans des scénarios où les erreurs ne génèrent pas de message visible pour l'utilisateur : On peut ainsi conserver une piste technique
de ce qui s'est produit sans alerter l'utilisateur final, garantissant une meilleure expérience.
- L'usage de Trace dans les applications collaboratives permet aux développeurs de suivre des comportements non reproductibles : Les journaux enregistrés
peuvent être analysés a posteriori même lorsque l'utilisateur ne peut pas décrire précisément le problème rencontré.
- La traçabilité fournie par Trace améliore le cycle de développement et de maintenance : Elle favorise une compréhension claire de la logique exécutée
dans Power Fx et réduit le temps nécessaire pour localiser et corriger les erreurs.
Dernière mise à jour : Jeudi, le 1 Mai 2025
