通过

Power Pages DevTools 扩展

  • 项目

Microsoft Edge DevTools 的 Power Pages 扩展是一款开发者工具，旨在为在 Power Pages 站点上工作的旨在者和管理员增强开发和故障排除体验。 它提供显示 Liquid 追踪消息和服务器端错误消息等功能。 借助该工具，制作者和管理员可以有效地识别、诊断和解决 Power Pages 环境中的问题。 通过在动态代码中启用日志记录和跟踪功能，以及提供对错误方案的清晰见解，Power Pages 扩展有助于更顺畅的开发工作流并提高 Power Pages 站点的整体质量。

备注

开发者工具扩展目前仅适用于 Microsoft Edge。

要使用开发者工具，您需要：

  • 安装浏览器扩展。
  • 启用诊断设置。
  • 检查服务器端错误并遵循缓解措施的详细信息。
  • 查看使用动态代码添加的自定义日志消息。

安装浏览器开发工具扩展

要安装 Power Pages 的 DevTools 扩展：

  1. 转到Microsoft Edge 的 Microsoft Power Pages 扩展。
  2. 选择获取。

启用诊断设置

备注

如果您的站点可见性状态为私密，则默认情况下会启用诊断设置。

要启用公共网站的诊断设置：

  1. 打开 Power Pages Management 应用程序。
  2. 使用名称 UserTrace/Debug 添加或更新站点设置。
  3. 将该值设置为 true。

查看服务器端错误消息

当您启用诊断设置时，平台会记录服务器上发生的任何错误。 要捕获这些服务器错误消息，您需要：

  1. 打开 Microsoft Edge 网络浏览器。

  2. 导航到您的 Power Pages 网站。

  3. 打开浏览器 DevTools。

  4. 选择 Power Pages 选项卡。

    选择了 Power Pages 选项卡的 Microsoft Edge DevTools 的屏幕截图。

  5. 重现您遇到错误的场景。

该工具显示所有服务器端错误消息的列表以及可能的解决方法。

备注

目前，您可能只会看到有限数量的失败错误消息。 但是，每个后续版本都将包含针对各种类型故障的额外错误消息。

以下是一些错误消息示例：

  • 如果门户联系人的 LogonEnabled 属性为 false，则本地登录提供程序出错。

    Microsoft Edge DevTools 的屏幕截图，其中选择了 Power Pages 选项卡并显示了错误消息示例。

  • 未正确配置外部实体搜索。

使用 Liquid 记录自定义消息

制作者可以在其 Liquid 代码中添加日志语句。 当 Power 页面站点运行时，制作者在 Liquid 代码中添加的日志显示在 Power Pages 开发人员工具扩展中。 制作者能够在其 Liquid 代码中加入日志语句。 当诊断设置启用时，这些由制作者嵌入的日志将显示在开发者工具扩展中。

以下语法可在 Liquid 代码中用于记录自定义消息：

{% log message:'Custom message' level:'Warning' %}

参数 Description
日志 Liquid 对象名称
消息 表示要记录的任何自定义消息的字符串
级别 将消息记录为信息、警告或错误

示例:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}