Power Platform中的Trace函数：用法详解与实战示例

Power Platform中的Trace函数：用法详解与实战示例

在Power Platform中，Trace函数是一个非常实用的工具，可以帮助开发者更好地理解和调试应用。本文将详细介绍Trace函数的用途、语法和使用示例，帮助读者更好地掌握这一工具。

适用场景

Trace函数适用于画布应用、模型驱动应用和Power Platform CLI。在应用开发过程中，Trace函数可以帮助开发者记录诊断信息，创建应用运行时间线，从而更好地了解应用的运行情况，帮助调试问题。

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

语法

Trace函数的语法如下：

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

• Message：必需。要跟踪的信息。可以是数字、日期、布尔值等可以转换为文本的数据类型。
• TraceSeverity：可选。监视器和Application Insights中记录的Trace的严重性级别。选项包括TraceSeverity.Information（默认）、TraceSeverity.Warning、TraceSeverity.Error或TraceSeverity.Critical。
• CustomRecord：可选。包含将记录到监视器或Application Insights中的自定义数据的记录。
• TraceOptions：可选。选项包括TraceOptions.None（默认）和TraceOptions.IgnoreUnsupportedTypes，后者将忽略CustomRecord中无法序列化的数据类型。

使用示例

1. 在Power Apps Studio中创建一个button控件。
2. 将OnSelect公式设置为以下公式：

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

3. 在另一个浏览器窗口中打开Power Apps监视器：
   

4. 返回到原始的工作室浏览器窗口，选择您的按钮四次。如果处于设计模式，使用鼠标上的Alt-单击。

5. 查看Power Apps监视器。监视器的网格将包含每个按钮单击和每个Trace调用的事件，将在每次增量后显示变量的值。钻取Trace事件，在右侧面板中查看发起Trace的位置以及用于消息的表达式：
   

注意事项

当与Test Studio一起使用时，Trace是一个可选表达式，可用于在来自OnTestCaseComplete事件的测试结果中提供其他信息。Trace事件消息与TestCaseResult记录的Traces表中的通过和失败的断言消息组合在一起。Traces表有两个属性：Message和Timestamp。测试中使用的跟踪信息也将记录在Application Insights中。

当从Power Apps Studio播放监视器时，由于监视器已连接到应用，测试跟踪信息在监视器工具中将不可用。

总结

Trace函数是Power Platform中一个非常实用的调试工具，可以帮助开发者更好地理解和调试应用。通过本文的介绍，相信读者已经掌握了Trace函数的基本用法和注意事项，可以开始在实际开发中使用这一工具了。