Trace 函数

适用于:画布应用模型驱动应用 Power Platform CLI

应用中通常有很多逻辑在后台工作。 有时影响很明显,例如,控件的值或颜色发生变化,从而确认逻辑操作正确。 但是,有时这并不明显,很难想象和了解应用内部发生的情况。 使用 Trace 函数可以从后台记录诊断信息,创建实际发生情况的时间线,进而更好地了解应用的运行情况,帮助调试问题。

在 Power Apps 中使用时,Trace 的输出与其他应用活动一起出现在 Power Apps 监视器工具中。 如果已允许应用将遥测数据发送到 Azure Application Insights,则还可以使用 Trace 函数将信息发送到 Application Insights 资源。 Trace 只能在行为公式中使用。

Test Studio 一起使用时,Trace 是一个可选表达式,可用于在来自 OnTestCaseComplete 事件的测试结果中提供其他信息。 Trace 事件消息将与 TestCaseResult 记录的 Traces 表中的已通过和失败的断言消息组合。 Traces 表有两个属性:MessageTimestamp。 测试中使用的跟踪信息也将记录在 Application Insights 中。 当从 Power Apps Studio 播放监视器时,由于监视器已连接到应用,测试跟踪信息在监视器工具中将不可用。

语法

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

  • Message – 必需。 要跟踪的信息。 数字、日期、布尔值和任何其他可以强制转换为文本的数据类型。
  • TraceSeverity – 可选。 监视器和 Application Insights 中记录的 Trace 的严重性级别。 选项为 TraceSeverity.Information(默认)、TraceSeverity.WarningTraceSeverity.ErrorTraceSeverity.Critical
  • CustomRecord – 可选。 包含将记录到监视器或 Application Insights 中的自定义数据的记录。
  • TraceOptions – 可选。 选项有 TraceOptions.None(默认)和 TraceOptions.IgnoreUnsupportedTypes,将忽略 CustomRecord 中无法序列化的数据类型。

示例

  1. 在 Power Apps Studio 中创建 button 控件。
  2. OnSelect 公式设置为以下公式:
Set( x, x+1 );
Trace( x );
  1. 通过选择左侧窗格中的“高级工具”图标并选择“打开监视器”,在另一个浏览器窗口中打开 Power Apps 监视器:Power Apps 监视器的入口点
  2. 返回到原始的工作室浏览器窗口,选择您的按钮四次。 如果处于设计模式,使用鼠标上的 Alt-单击
  3. 查看 Power Apps 监视器。
  4. 监视器的网格将包含每个按钮单击和每个 Trace 调用的事件,将在每次增量后显示变量的值。 钻取 Trace 事件,在右侧面板中查看发起 Trace 的位置以及用于消息的表达式:显示按钮被按下四次以及变量的相应增量的监视器跟踪

另请参阅

Power Apps 监视器概述
Test Studio 概述
使用 Test Studio