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 è evidente, ad esempio il valore di un controllo o il cambiamento di un colore, confermando che la logica ha funzionato 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 Monitoraggio di Power Apps 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.

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 dei test non saranno disponibili nello strumento Monitoraggio poiché il monitoraggio è collegato all'app quando viene riprodotto 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 convertito in testo.
• TraceSeverity – Facoltativo. Livello di gravità del Trace record in Monitoraggio e Application Insights. Le opzioni sono TraceSeverity.Information (default), TraceSeverity.Warning, TraceSeverity.Error, o TraceSeverity.Critical.
• CustomRecord – Facoltativo. Record contenente dati personalizzati che verranno registrati in Monitoraggio o Application Insights.
• TraceOptions – Facoltativo. Le opzioni sono TraceOptions.None (predefinito) 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. Apri il Monitoraggio di Power Apps in un'altra finestra del browser selezionando l'icona "Strumenti avanzati" nel riquadro a sinistra e selezionando "Apri monitor":
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. Visualizza il monitoraggio di Power Apps.
6. La griglia di Monitoraggio 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

Power Apps Panoramica del monitor
Test Studio Panoramica
Lavorare con Test Studio