Trace Fonction

S’applique à : Applications Canvas Copilot Studio Basées sur des modèles , applications Power Platform CLI Dataverse functions

Il y a souvent beaucoup de logique dans les coulisses d’une application. Parfois, l’impact est évident, par exemple la valeur ou la couleur d’un contrôle change, ce qui confirme que la logique a fonctionné correctement. Cependant, parfois, ce n’est pas évident et il peut être difficile de visualiser et de comprendre ce qui se passe à l’intérieur de l’application. Utilisez la Trace fonction pour enregistrer les informations de diagnostic en arrière-plan, en créant une chronologie de ce qui s’est réellement passé, pour mieux comprendre le fonctionnement de votre application et aider à déboguer les problèmes.

Lorsqu’elle est utilisée dans Power Apps, la sortie s’affiche Trace dans l’outil Power Apps Monitor , ainsi que d’autres activités d’application. Si vous avez autorisé votre application à envoyer des données de télémétrie à Azure Application Insights, la Trace fonction peut également être utilisée pour envoyer des informations à votre ressource Application Insights. Trace ne peut être utilisé que dans les formules de comportement.

Lorsqu’elle est utilisée avec Test Studio, Trace est une expression facultative qui peut être utilisée pour fournir des informations supplémentaires dans vos résultats de test à partir de l’événement OnTestCaseComplete . Trace Les messages d’événement sont combinés avec les messages d’assertion passés et ayant échoué dans la table Traces de l’enregistrement TestCaseResult . La table Traces a deux propriétés : Message et Timestamp. Trace les informations utilisées dans les tests seront également enregistrées dans Application Insights. Les informations de suivi d’essai ne sont pas disponibles dans l’outil de surveillance, car le contrôleur est connecté à l’application lors de sa lecture depuis Power Apps Studio.

Syntaxe

Trace( Message [, TraceSeverity [, CustomRecord [, TraceOptions ] ] )

• Message – Obligatoire. Information à suivre. Nombres, dates, valeurs booléennes et tout autre type de données pouvant être converti en texte.
• TraceSeverity – Facultatif. Niveau de gravité de l’enregistrement Trace dans Monitor et Application Insights. Les options sont TraceSeverity.Information (default), TraceSeverity.Warning, TraceSeverity.Error, ou TraceSeverity.Critical.
• CustomRecord – Facultatif. Enregistrement contenant des données personnalisées qui sont enregistrées dans le Moniteur ou Application Insights.
• TraceOptions – Facultatif. Les options sont TraceOptions.None (par défaut) et TraceOptions.IgnoreUnsupportedTypes qui ignorera les types de données dans CustomRecord qui ne peuvent pas être sérialisés.

Exemple

1. Créez un contrôle de bouton dans Power Apps Studio.
2. Définissez la formule OnSelect sur la formule suivante :

Set( x, x+1 );
Trace( x );

3. Ouvrez le Moniteur Power Apps dans une autre fenêtre de navigateur en sélectionnant l’icône « Outils avancés » dans le volet de gauche et sélectionnez « Ouvrir le moniteur » :
4. Revenez à la fenêtre du navigateur Studio d’origine et sélectionnez votre bouton quatre fois. Utilisez Alt-clic sur votre souris si vous êtes en mode conception.
5. Affichez le Moniteur Power Apps.
6. La grille du moniteur contient un événement pour chaque clic de bouton et pour chaque Trace appel, qui affiche la valeur de la variable après chaque incrément. Explorer un Trace événement pour voir où l’a Trace été lancé et l’expression utilisée pour le message, dans le panneau de droite :

Voir aussi

Power Apps Présentation du moniteur
Test Studio Aperçu
Travailler avec Test Studio