De functie Trace

  • Artikel

Van toepassing op: Canvas-apps Modelgestuurde apps Power Platform CLI

Vaak zit er veel logica in een app die niet direct zichtbaar is. Soms is de impact duidelijk, bijvoorbeeld de waarde van een besturingselement of een kleur die verandert, wat bevestigt dat de logica correct werkt. Soms is het echter niet duidelijk en kan het moeilijk zijn om te visualiseren en te begrijpen wat er in de app gebeurt. Gebruik de functie Trace om de diagnostische informatie achter de schermen vast te leggen, een tijdlijn te maken van wat er werkelijk is gebeurd, om beter te begrijpen hoe uw app werkt en om problemen op te lossen.

Bij gebruik in Power Apps verschijnt de uitvoer van Trace in de tool Power Apps Monitor samen met andere app-activiteiten. Als u uw app hebt gemachtigd om telemetriegegevens te verzenden naar Azure Application Insights, kan de functie Trace ook worden gebruikt om aangepaste gebeurtenisgegevens of diagnostische gegevens naar uw Application Insights-resource te verzenden. Trace kan alleen worden gebruikt in gedragsformules.

In Test Studio is Trace een optionele expressie waarmee aanvullende informatie kan worden gegeven in de testresultaten uit de gebeurtenis OnTestCaseComplete. Gebeurtenisberichten voor Trace worden gecombineerd met berichten voor zowel geslaagde als mislukte asserties in de tabel Traces in de record TestCaseResult. De tabel Traces heeft twee eigenschappen, Message en Timestamp. Trace-gegevens die in tests worden gebruikt, worden ook vastgelegd in Application Insights. Testtrace-informatie is niet beschikbaar in het hulpprogramma Monitor, omdat de Monitor is verbonden met de app wanneer deze wordt afgespeeld vanuit Power Apps Studio.

Syntaxis

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

  • Message: vereist. De informatie die moet worden getraceerd. Getallen, datums, booleaanse en elk ander gegevenstype dat kan worden omgezet in tekst.
  • TraceSeverity: optioneel. Het ernstniveau voor de Trace-functie die wordt vastgelegd in Monitor en Application Insights. Opties zijn TraceSeverity.Information (standaard), TraceSeverity.Warning, TraceSeverity.Error of TraceSeverity.Critical.
  • CustomRecord: optioneel. Een record met aangepaste gegevens die in Monitor of Application Insights wordt vastgelegd.
  • TraceOptions: optioneel. Opties zijn TraceOptions.None (standaard) en TraceOptions.IgnoreUnsupportedTypes waardoor gegevenstypen in CustomRecord die niet kunnen worden geserialiseerd, worden genegeerd.

Voorbeeld

  1. Maak een besturingselement Button in Power Apps Studio.
  2. Stel de formule OnSelect in op de volgende formule:
Set( x, x+1 );
Trace( x );
  1. Open de Power Apps Monitor in een ander browservenster door het pictogram Geavanceerde tools in het linkerdeelvenster te selecteren en selecteer Monitor openen: toegangspunt voor Power Apps Monitor
  2. Keer terug naar het oorspronkelijke Studio-browservenster en selecteer uw knop vier keer. Gebruik Alt-klik op uw muis in de ontwerpmodus.
  3. Geef de Power Apps Monitor weer.
  4. Het raster van de Monitor zal een gebeurtenis bevatten voor elke klik op een knop en voor elke Trace-aanroep, die de waarde van de variabele toont na elke verhoging. Zoom in op een Trace-gebeurtenis om te zien waar de Trace is geïnitieerd en welke expressie voor het bericht is gebruikt, in het rechterdeelvenster: Monitortrace die laat zien dat de knop vier keer wordt ingedrukt en de overeenkomstige verhogingen van een variabele

Zie ook

Overzicht van Power Apps Monitor
Overzicht van Test Studio
Werken met Test Studio