Trace funció

S'aplica a: Aplicacions de llenç Copilot Studio Aplicacions basades en models CLI del Power Platform Funcions del Dataverse

Sovint hi ha molta lògica treballant entre bastidors en una aplicació. De vegades l'impacte és evident, per exemple, el valor o el color d'un control canvia, confirmant que la lògica funcionava correctament. Tanmateix, de vegades no és obvi i pot ser difícil visualitzar i entendre què passa dins de l'aplicació. Utilitzeu la Trace funció per registrar informació de diagnòstic entre bastidors, creant una cronologia del que realment ha passat, per entendre millor com funciona l'aplicació i per ajudar a depurar problemes.

Quan s'utilitza a Power Apps, la sortida de Trace apareix a l'eina Power Apps Live Monitor juntament amb altres activitats de l'aplicació. Si has permès que la teva aplicació enviï dades de telemetria a Azure Application Insights, la Trace funció també es pot utilitzar per enviar informació al teu recurs d'Application Insights. Trace Només es poden utilitzar en fórmules de comportament : per traçar valors a partir de propietats de dades, cal utilitzar alternatives com botons de depuració.

Quan s'utilitza amb Test Studio, Trace és una expressió opcional que es pot utilitzar per proporcionar informació addicional als resultats de la prova de l'esdeveniment OnTestCaseComplete . Trace els missatges d'esdeveniment es combinen amb els missatges d'asserció passats i fallits a la taula Traces del registre TestCaseResult . La taula Traces té dues propietats, Message i Timestamp. Trace la informació utilitzada en les proves també es registrarà a Application Insights. La informació del rastreig de prova no està disponible a l'eina Live Monitor, ja que el Live Monitor està connectat a l'aplicació quan es reprodueix des del Power Apps Studio.

Sintaxi

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

• Missatge : obligatori. La informació de la qual es farà un seguiment. Nombres, Dates, Booleans i qualsevol altre tipus de dades que es pugui forçar a enviar un Text.
• TraceSeverity : opcional. El nivell de Trace gravetat registrat a Live Monitor i Application Insights. Les opcions són TraceSeverity.Information (per defecte), TraceSeverity.Warning,TraceSeverity.Error o TraceSeverity.Critical.
• CustomRecord : opcional. Un registre que conté dades personalitzades que es registren a Live Monitor o Application Insights.
• TraceOptions : opcional. Les opcions són TraceOptions.None (per defecte) i TraceOptions.IgnoreUnsupportedTypes , que ignoren els tipus de dades a CustomRecord que no es poden serializar.

Exemple

1. Creeu un control de botó en Power Apps Studio.
2. Definiu la fórmula OnSelect a la fórmula:

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

3. Obre el monitor en directe de Power Apps en una altra finestra del navegador seleccionant la icona "Eines avançades" al panell esquerre i selecciona "Obre monitor en directe":
4. Torneu a la finestra original del navegador Studio i seleccioneu el botó quatre vegades. Utilitzeu Alt-clic al ratolí si esteu en mode de disseny.
5. Mira el monitor en viu de Power Apps.
6. La graella del Live Monitor contindrà un esdeveniment per a cada clic de botó i per a cada Trace trucada, que mostrarà el valor de la variable després de cada increment. Perfora un Trace esdeveniment per veure on s'ha Trace iniciat el missatge i l'expressió utilitzada pel missatge, al panell dret:

Vegeu també

Visió general del monitor en viu de Power Apps
Test Studio Visió general
Treballar amb Test Studio