Trace-Funktion

Gilt für: Canvas-Apps Copilot Studio Modellgesteuerte Apps Power Platform CLI Dataverse-Funktionen

Oft arbeitet in einer App eine Menge Logik hinter den Kulissen. Manchmal ist die Auswirkung offensichtlich, z.B. wenn sich der Wert oder die Farbe eines Steuerelements ändert, was bestätigt, dass die Logik korrekt funktioniert hat. Manchmal ist es jedoch nicht offensichtlich und es kann schwierig sein, zu visualisieren und zu verstehen, was innerhalb der App geschieht. Verwenden Sie die Trace Funktion, um Diagnoseinformationen aus den Kulissen aufzuzeichnen, eine Zeitachse zu erstellen, die tatsächlich passiert ist, um besser zu verstehen, wie Ihre App funktioniert und um Probleme zu debuggen.

Bei Verwendung in Power Apps wird die Ausgabe aus Trace dem Power Apps Monitor-Tool zusammen mit anderen App-Aktivitäten angezeigt. Wenn Sie Ihrer App das Senden von Telemetriedaten an Azure Application Insights gestattet haben, kann die Trace Funktion auch verwendet werden, um Informationen an Ihre Application Insights-Ressource zu senden. Trace kann nur in Verhaltensformeln verwendet werden.

Bei Verwendung mit Test Studio ist ein optionaler Ausdruck, der verwendet werden kann, Trace um zusätzliche Informationen in Den Testergebnissen aus dem OnTestCaseComplete-Ereignis bereitzustellen. Trace Ereignismeldungen werden mit übergebenen und fehlgeschlagenen Assertionsmeldungen in der Tabelle "Ablaufverfolgungen " des TestCaseResult-Datensatzes kombiniert. Die Tabelle Spuren hat zwei Eigenschaften, Nachricht und Zeitstempel. Trace Informationen, die in Tests verwendet werden, werden auch in Application Insights aufgezeichnet. Informationen zur Testverfolgung sind im Monitor Tool nicht verfügbar, da der Monitor mit der App verbunden ist, wenn er von der Power Apps Studio abgespielt wird.

Syntax

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

• Nachricht – Erforderlich. Dies sind die nachzuverfolgenden Informationen. Zahlen, Daten, boolesche und alle anderen Datentypen, die in Text umgewandelt werden können.
• TraceSeverity – Optional. Der Schweregrad der Trace aufgezeichneten Überwachungs- und Anwendungserkenntnisse. Optionen sind TraceSeverity.Information (Standard), TraceSeverity.Warning, TraceSeverity.Error oder TraceSeverity.Critical.
• CustomRecord – Optional. Ein Datensatz mit angepassten Daten, die in Monitor oder Application Insights aufgezeichnet werden.
• TraceOptions – Optional. Optionen sind TraceOptions.None (Standard) und TraceOptions.IgnoreUnsupportedTypes, die Datentypen in CustomRecord, die nicht serialisiert werden können, ignorieren.

Beispiel

1. Erstellen Sie ein Steuerelement für eine Schaltfläche in Power Apps Studio.
2. Legen Sie die Formel OnSelect auf die Formel fest:

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

3. Öffnen Sie den Monitor Power Apps in einem anderen Browserfenster, indem Sie auf das Symbol „Erweiterte Tools“ im linken Fensterbereich klicken und „Monitor öffnen“ wählen:
4. Kehren Sie zum ursprünglichen Studio-Browserfenster zurück und wählen Sie Ihre Schaltfläche viermal aus. Verwenden Sie Alt-Klick auf Ihrer Maus, wenn Sie sich im Designmodus befinden.
5. Sehen Sie sich den Power Apps Monitor an.
6. Das Raster des Monitors enthält ein Ereignis für jeden Klick auf jede Schaltfläche und für jeden Trace Aufruf, der den Wert der Variablen nach jedem Inkrement anzeigt. Drill into a Trace event to see where the Trace was initiated, and the expression used for the message, in the right panel:

Siehe auch

Power Apps Monitorübersicht
Test Studio Übersicht
Arbeiten mit Test Studio