使用 Live Monitor 对模型驱动应用行为进行故障排除

Live Monitor 是一种工具,可以帮助应用程序制作者调试和诊断问题,从而帮助他们构建更快、更可靠的应用程序。 Live Monitor 通过提供应用程序运行时所有活动的日志,提供应用程序运行方式的深入视图。

为了帮助您隔离某些模型驱动应用功能,您可以筛选特定类别,如窗体或 Copilot 控件。

创建实时监控器会话

登录到 Power Apps,在左侧导航窗格中选择解决方案,打开包含您要监控的应用的解决方案,选择该应用,然后在命令栏中选择实时监控

在实时监视器页面上,选择 命令栏上的播放模型驱动 应用。 有关创建实时监控器会话的更多信息,请转到 使用实时监控器对模型驱动应用中的页面行为进行故障排除

在实时监控器中筛选模型驱动应用表单相关事件可以在应用运行时提供有关实时监控器中表单上的相关表、表、控件和组件的信息。

在许多情况下,Live Monitor 可以帮助制作者了解表单为何以某种方式运行。 许多窗体问题都是基于业务规则、JavaScript、窗体事件或管理员和制作者设置的客户端 API。 实时监视器还可以帮助确定遇到的问题是现成的,还是由于自定义造成的。 它提供有助于回答以下问题的详细信息:

  1. 在运行 Live monitor 的浏览器窗口上,选择 Category 列,然后选择 Filter by

    在 Live Monitor 中筛选表单事件。

  2. 从下拉列表中选择等于包含,然后在框中输入 formchecker。 选择应用

    输入窗体检查器筛选器
  3. 现在类别已经过筛选。 通过选择并按住列右侧并向右拖动可以展开操作列来查看所跟踪事件的完整名称。 当您使用应用程序并打开和使用表单时,Live Monitor 会更新事件列表。

    显示的受监视窗体事件。

  4. 当应用在受监控的会话中运行时,在模型驱动应用中执行与正常使用应用一致的操作。 例如,使用表窗体打开和更改数据。

使用 Live Monitor 了解表单行为

对于具有实时监控器的每一行,可以查看有关表单事件的详细信息。 例如,假设您对窗体中发生的错误有疑问。 您在应用中转到该窗体,然后选择相应的窗体组件。 然后返回到启用了 Live Monitor 的浏览器,并查看结果(无论是否进行筛选)。 在这种情况下,复合控件上有一个错误。 通过展开详细信息的区域,您可以了解有关事件本身的详细信息。

监视相关菜单。

有很多类型的事件会被监视,包括标准窗体事件,如 onloadonsaveonclose

当您继续使用正在监控的应用程序时,Live Monitor 会更新事件列表中的信息。 对于窗体,您可以对很多不同的场景进行故障排除,找到有关当前正在处理的窗体、控件或表的其他信息。

表单检查区域和事件

表单监控包括以下几个方面。

应用区域 Description
控件状态 有关加载窗体时控件的可见、已启用和标签源状态。
相关菜单 有关相关菜单项状态的详细信息。 示例:
为什么未在显示某个菜单项?
菜单项来自何处?
选项卡/节/控件状态更改 关于谁(通过调用堆栈)导致窗体组件(如选项卡、节段或控件)更改组件的可见性和启用状态的详细信息。
导航 通过跟踪这些 Xrm.Navigation 客户端 API 方法的调用堆栈,详细了解导致导航或意外对话的原因:openAlertDialog(), openConfirmDialog(), openDialog(), openErrorDialog(), navigateTo(), openForm(), openTaskFlow(), openUrl(), openWebResource()
不支持的自定义设置 有关窗体准备就绪之前不受支持的客户端 API 访问的详细信息。 示例:
在窗体完全加载之前访问 iFrame 中的 parent.Xrm.Page
使用 window.setTimeout() 访问窗体处理程序上下文之外的窗体 Web 资源中的 Xrm.Page 来定期调用窗体客户端 API。
在 Power Apps control framework 控制代码的 updateView() 方法中访问 Xrm.Page

Live Monitor 中支持的表单相关事件示例包括:

  • FormEvents.onsave
  • XrmNavigation
  • FormEvents.onload
  • FormControls
  • TabStateChange.visible
  • RelatedMenu
  • ControlStateChange.disabled
  • ControlStateChange.visible
  • SectionStateChange.visible
  • UnsupportedClientApi
  1. 在运行 Live monitor 的浏览器窗口上,选择 Category 列,然后选择 Filter by
  2. 从下拉列表中选择等于包含,然后在框中输入 CopilotEvent。 选择应用

Copilot 控件事件

Copilot 控制监视的事件包括以下内容。

事件名称 Description
AdaptiveCardActionData 发送到自适应卡片的提交操作的数据
adaptiveCardContent 适配卡的内容
AISummarize 如果总结功能关闭,则会记录此消息,并记录 fcb 状态
AutoTriggerSummarizeHandler.isAutoTriggeredSummaryEnabled 指示是否启用自动扳机键
ClientActionCalled 记录客户端操作的名称和传递给它的负载
CopilotResponse 助手的回应
DVCopilotAction isDVChatEnabled:组织是否启用 dv 聊天
DynamicContextSentToBot 动态上下文已发送到机器人
EnvironmentHostedBotSchemaName 记录环境机器人模式名称
ExecutingAction 正在执行自适应卡片操作
isSummaryEnabledForEntity 告知是否为实体启用了 summarize
queryStructuredDataRequest 向查询结构数据发送请求
queryStructuredDataResponse 来自查询结构数据的回复
SessionContextSentToBot 会话上下文已发送到机器人
SummarizeResponse 记录对汇总的回复
UserPrompt 用户输入的提示

关闭监控会话

要关闭监控会话,请关闭正在播放被监控的模型驱动应用程序的浏览器选项卡。

后续步骤

有关如何解决模型驱动应用中的窗体问题的详细信息,请参阅解决模型驱动应用中的窗体问题

了解 Live monitor 作为 Power Apps 工具