Funzione Trace

Si applica a: App Canvas- App basate su modello di Copilot Studio Funzioni di Dataverse dell'interfaccia della riga di comando di Power Platform

Spesso c'è molta logica che lavora dietro le quinte in un'app. A volte l'impatto è ovvio, ad esempio, il valore o il colore di un controllo, confermando la logica eseguita correttamente. Tuttavia, a volte non è ovvio e può essere difficile visualizzare e capire cosa sta succedendo all'interno dell'app. Usare la Trace funzione per registrare le informazioni di diagnostica da dietro le quinte, creando una sequenza temporale di ciò che è accaduto, per comprendere meglio il funzionamento dell'app e per facilitare il debug dei problemi.

Se usato in Power Apps, l'output di Trace viene visualizzato nello strumento Power Apps Live Monitor insieme ad altre attività dell'app. Se è stato consentito all'app di inviare dati di telemetria ad Azure Application Insights, la Trace funzione può essere usata anche per inviare informazioni alla risorsa di Application Insights. Trace può essere usato solo nelle formule di comportamento : per tracciare i valori dalle proprietà dei dati, è necessario usare alternative come i pulsanti di debug.

Se usato con Test Studio, Trace è un'espressione facoltativa che può essere usata per fornire informazioni aggiuntive nei risultati del test dall'evento OnTestCaseComplete . Trace i messaggi di evento vengono combinati con messaggi di asserzione passati e non riusciti nella tabella Traces del record TestCaseResult . La tabella Traces include due proprietà, Message e Timestamp. Trace le informazioni usate nei test verranno registrate anche in Application Insights. Le informazioni di traccia di test non sono disponibili nello strumento Live Monitor perché Live Monitor è connesso all'app quando viene riprodotta da Power Apps Studio.

Sintassi

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

• Messaggio – Obbligatorio. Informazioni di cui tenere traccia. Numeri, date, valori booleani e qualsiasi altro tipo di dati che può essere costretto a Testo.
• TraceSeverity – Facoltativo. Livello di gravità del Trace record in Monitoraggio live e Application Insights. Le opzioni sono TraceSeverity.Information (default), TraceSeverity.Warning, TraceSeverity.Error, o TraceSeverity.Critical.
• CustomRecord – Facoltativo. Record contenente dati personalizzati registrati in Live Monitor o Application Insights.
• TraceOptions – Facoltativo. Le opzioni sono TraceOptions.None (impostazione predefinita) e TraceOptions.IgnoreUnsupportedTypes che ignora i tipi di dati in CustomRecord che non possono essere serializzati.

Esempio

1. Crea un controllo Button in Power Apps Studio.
2. Imposta la formula OnSelect sulla formula:

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

3. Aprire Power Apps Live Monitor in un'altra finestra del browser selezionando l'icona "Strumenti avanzati" nel riquadro a sinistra e selezionare "Apri monitoraggio live":
4. Torna alla finestra originale del browser di Studio e seleziona il pulsante quattro volte. Usa Alt-click sul tuo mouse se sei in modalità di progettazione.
5. Visualizzare Power Apps Live Monitor.
6. La griglia di Monitoraggio live conterrà un evento per ogni clic del pulsante e per ogni Trace chiamata, che mostrerà il valore della variabile dopo ogni incremento. Esaminare un Trace evento per vedere dove è stato avviato l'oggetto Trace e l'espressione usata per il messaggio, nel pannello di destra:

Vedere anche

Panoramica di Power Apps Live Monitor
Test Studio Panoramica
Lavorare con Test Studio