Condividi tramite

Funzione Trace

  • Articolo

Si applica a: App canvas App basate su modello 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. Usa la funzione Trace per registrare informazioni diagnostiche da dietro le quinte, creando una sequenza temporale di ciò che è realmente accaduto, per capire meglio come funziona la tua app e per aiutare a risolvere i problemi.

Se utilizzata in Power Apps, l'output di Trace appare nello strumento Monitoraggio di Power Apps insieme ad altre attività di app. Se hai consentito alla tua app di inviare dati di telemetria a Azure Application Insights, la funzione Trace può essere usata anche per inviare informazioni alla risorsa Application Insights. La funzione Trace può essere usata solo nelle formule relative al comportamento.

Quando viene usata con Test Studio, Trace è un'espressione facoltativa utilizzabile per fornire informazioni aggiuntive nei risultati dei test dell'evento OnTestCaseComplete. I messaggi di evento di Trace vengono combinati con i messaggi di asserzione passati e non riusciti nella tabella Traces del record TestCaseResult. La tabella Traces include due proprietà, Message e Timestamp. Le informazioni di traccia 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 ] ] ] )

  • Message: 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à della traccia registrata 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 );
  1. 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": punto di ingresso per monitoraggio di Power Apps
  2. 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.
  3. Visualizza il monitoraggio di Power Apps.
  4. La griglia del Monitoraggio conterrà un evento per ogni clic del pulsante e per ogni chiamata Trace, che mostrerà il valore della variabile dopo ogni incremento. Analizza un evento Trace per vedere dove è stato avviato Trace e l'espressione utilizzata per il messaggio, nel riquadro di destra: traccia del monitoraggio che mostra il pulsante premuto quattro volte e gli incrementi corrispondenti di una variabile

Vedere anche

Panoramica del monitoraggio di Power Apps
Panoramica di Test Studio
Utilizzo di Test Studio