为HTML5表单启用日志记录

最近更新： 2023年5月4日
  • 主题：

创建对象：

  • 用户
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

您可以配置日志记录器实用程序，以开始为HTML5表单创建日志。 记录器实用程序具有各种级别，您可以根据自己的要求设置一个级别。 HTML5表单具有服务器和客户端组件。 您可以为这两个组件配置日志。

配置服务器端日志记录

执行以下步骤以配置服务器端日志：

  1. 转到 https://[server]:[port]/system/console/configMgr. 找到并打开 Apace Sling日志记录器配置 选项。 将出现一个对话框：

    Apace Sling日志记录记录器配置选项对话框

    Apace Sling日志记录器配置选项

  2. 更改 日志级别 to 调试.

  3. 指定的名称和路径 日志文件.

    NOTE
    要在HTML5表单日志目录中生成日志，请在文件名前添加……/logs/ 。

  4. 更改 记录器 to HTMLFormsPerfLogger。 ​单击“保存”。

配置客户端日志记录

您可以使用以下方法在HTML5表单中启用客户端日志记录：

  • 使用名为的请求参数 log
  • 使用CQ配置管理器

使用请求参数启用日志记录

使用此方法，您可以为特定请求生成日志。 请求参数的名称为 日志. 日志URL如下：

https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<path of the folder containing form xdp>&template=<name of the xdp>&log=<log configuration>.

日志配置由日志级别和日志记录器类别组成。

日志目标

日志目标描述
1日志会定向到浏览器 控制台
2日志在客户端的JavaScript对象中收集，并可以发布到 服务器
3上述两个选项

日志级别

日志级别描述
0关闭
1致命
2错误
3警告
4信息
5调试
6TRACE
7全部

记录器类别

日志类别描述
axfa（编写引擎相关日志的脚本）
bxfaView（布局引擎相关日志）
cxfaPerf（与性能相关的日志）

日志配置

在日志URL中，日志配置查询字符串参数的定义如下：

{destination}-{a level}-{b level}-{c level}

例如：

日志配置描述
2-a4-b5-c6目标：服务器
xfa级别：信息
xfaView级别：调试
xfaPerf级别：TRACE
NOTE
每个日志类别a(xfa)、b(xfaView)和c(xfaPerf)的默认日志级别为2(ERROR)。 因此，对于日志配置：2-b6，不同类别的日志级别为：
a(xfa):2（默认级别错误）
b(xfaView):6(用户指定的TRACE)
a(xfaPerf):2（默认级别错误）

使用配置管理器启用日志记录

如果使用配置管理器启用日志记录，则会为每个渲染请求生成日志，直到再次禁用日志记录。

  1. 登录到CQ Configuration Manager(位于 https://[server]:[port]/system/console/configMgr 和使用管理员凭据登录。

  2. 搜索并单击 移动Forms配置.

  3. 在“调试选项”文本框中，输入上一节中所述的日志配置，例如， 2-a4-b5-c6

    表单配置

    表单配置

上传日志

如果目标设置为1，则所有客户端脚本日志消息都会定向到控制台。 如果管理员需要这些日志以及服务器日志，请将目标级别设置为2。 在此级别，所有日志都会在客户端的JS对象中收集，如果表单使用默认配置文件呈现，则会 发送日志 按钮 突出显示现有字段 按钮。 当用户单击该链接时，所有收集的日志都会发布到服务器，并记录到服务器上配置的错误日志文件中。

默认情况下，所有信息都会添加到/crx-repository/logs/目录的error.log文件中。

要更改日志文件的位置和名称，请执行以下操作：

  1. 以管理员身份登录到配置管理器。 配置管理器的默认URL是 https://[*Server*]:[*Port*]/system/console/configMgr.

  2. 单击 Apache Sling日志记录器配置. 将显示一个对话框。

    logconfig-1

  3. 更改 日志级别 调试。

  4. 指定的路径和名称 日志文件.

    NOTE
    要在保存其他日志文件的同一目录中创建日志，请指定……/logs/<filename> 在“日志文件”属性中。

  5. 更改 记录器 to HTMLFormsPerfLogger 单击 保存.

有关此主题的更多帮助

上一页
下一页

Experience Manager