funktionen Trace

Gælder for: Copilot Studio Modeldrevne apps Power Platform CLI Dataverse-funktioner til lærredsapps

Ofte er der en masse logik, der arbejder bag kulisserne i en app. Nogle gange er virkningen indlysende, f.eks. et kontrolelements værdi- eller farveændringer, der bekræfter, at logikken fungerer korrekt. Men nogle gange er det ikke indlysende, og det kan være svært at visualisere og forstå, hvad der sker i appen. Brug funktionen Trace til at registrere diagnosticeringsoplysninger fra baggrunden, oprette en tidslinje over, hvad der faktisk skete, for bedre at forstå, hvordan din app fungerer, og for at hjælpe med fejlfinding af problemer.

Når outputtet bruges i Power Apps, vises outputtet Trace i værktøjet Power Apps Live Monitor sammen med andre appaktiviteter. Hvis du har tilladt, at din app sender telemetridata til Azure Application Insights, kan funktionen Trace også bruges til at sende oplysninger til din Application Insights-ressource. Trace kan kun bruges i formler for funktionsmåde – hvis du vil spore værdier fra dataegenskaber, skal du bruge alternativer, f.eks. fejlfindingsknapper.

Når den bruges sammen med Test Studio, er det et valgfrit udtryk, Trace der kan bruges til at angive yderligere oplysninger i dine testresultater fra hændelsen OnTestCaseComplete . Trace hændelsesmeddelelser kombineres med overførte og mislykkede antagelsesmeddelelser i tabellen Traces for posten TestCaseResult . Tabellen Traces har to egenskaber: Message og Timestamp. Trace oplysninger, der bruges i test, registreres også i Application Insights. Oplysninger om testsporing er ikke tilgængelige i værktøjet Live Monitor, da Live Monitor er forbundet til appen, når den afspilles fra Power Apps Studio.

Syntaks

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

• Besked – Påkrævet. De oplysninger, der skal spores. Tal, datoer, booleske værdier og andre datatyper, der kan gennemtvinges til Tekst.
• TraceSeverity – Valgfrit. Alvorsgradsniveauet for de Trace registrerede i Live Monitor og Application Insights. Mulighederne er TraceSeverity.Information (standard), TraceSeverity.Warning, TraceSeverity.Error eller TraceSeverity.Critical.
• CustomRecord – Valgfrit. En post, der indeholder brugerdefinerede data, der er registreret i Live Monitor eller Application Insights.
• TraceOptions – Valgfrit. Indstillingerne er TraceOptions.None (standard) og TraceOptions.IgnoreUnsupportedTypes , som ignorerer datatyper i CustomRecord , som ikke kan serialiseres.

Eksempel

1. Opret et knapkontrolelementet i Power Apps Studio.
2. Angiv handlingen OnSelect til følgende formel:

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

3. Åbn Power Apps Live Monitor i et andet browservindue ved at vælge ikonet "Avancerede værktøjer" i ruden til venstre og vælge "Åbn liveskærm":
4. Vend tilbage til det oprindelige browservindue i Studio, og vælg din knap fire gange. Brug Alt-klik med musen, hvis du er i designtilstand.
5. Få vist Power Apps Live Monitor.
6. Gitteret for Live Monitor indeholder en begivenhed for hvert klik på knappen og for hvert Trace kald, som viser værdien af variablen efter hvert trin. Analysér ind i en Trace hændelse for at se, hvor Trace blev startet, og det udtryk, der bruges til meddelelsen, i panelet til højre:

Se også

Oversigt over Power Apps Live Monitor
Test Studio Oversigt
Arbejde med Test Studio