Show Menu
主题×

为HTML5表单启用日志记录

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

配置服务器端日志记录

执行以下步骤以配置服务器端日志:
  1. 转到 https://'[server]:[port]'/system/console/configMgr . 找到并打开 Apace Sling日志记录器配置选项 。 将显示一个对话框:
    Apace Sling日志记录记录器配置选项
  2. 将“日志 级别 ”更改 为“调试 ”。
  3. 指定日志文件的名 称和路径
    要在HTML5表单日志目录中生成日志,请在文件名前添加……/logs/。
  4. Logger 更改 为HTMLFormsPerfLogger 。 单击​ 保存

配置客户端日志记录

可以使用以下方法在HTML5表单中启用客户端日志记录:
  • 使用名为 log
  • 使用CQ配置管理器

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

使用此方法,您可以为特定请求生成日志。 请求参数的名称为“log”。 日志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 DEBUG
6 TRACE
7 全部

记录器类别

日志类别 描述
某个 xfa(脚本引擎相关日志)
b xfaView(布局引擎相关日志)
c xfaPerf(与性能相关的日志)

日志配置

在日志URL中,日志配置查询字符串参数定义如下:
{destination}-{a level}-{b level}-{c level}
例如:
日志配置 描述
2-a4-b5-c6 目标:Server xfa级别:INFO xfaView级别:DEBUG xfaPerf级别:TRACE
每个日志类别a(xfa)、b(xfaView)和c(xfaPerf)的默认日志级别为2(ERROR)。 因此,对于日志配置:2-b6,不同类别的日志级别为: a(xfa):2(默认级别ERROR) b(xfaView):6(用户指定的TRACE) a(xfaPerf):2(默认级别ERROR)

使用Configuration Manager启用日志记录

如果使用配置管理器启用日志记录,则会为每个渲染请求生成日志,直到再次禁用日志记录。
  1. 登录CQ Configuration Manager,然后使 https://'[server]:[port]'/system/console/configMgr 用管理员凭据登录。
  2. 搜索并单击“移 动表单配置”
  3. 在“调试选项”文本框中,按照上一节所述输入日志配置,例如, 2-a4-b5-c6
    表单配置

上传日志

如果目标设置为1,则所有客户端脚本日志消息都将定向到控制台。 如果管理员需要这些日志和服务器日志,请将目标级别设置为2。 在此级别上,所有日志都收集在客户端的JS对象中,如果表单以默认用户档案呈现,则工具栏中“高亮显示现有字段 ”按钮的左侧将显示“发送日志”按钮。 当用户单击该链接时,所有收集的日志都将发布到服务器,并记录到服务器上已配置的错误日志文件中。
默认情况下,所有信息都会添加到/crx-repository/logs/目录下的error.log文件。
要更改日志文件的位置和名称:
  1. 以管理员身份登录到配置管理器。 配置管理器的默认URL为 https://'[server]:[port]'/system/console/configMgr
  2. 单击“ Apache Sling Logging Logger Configuration” 。 将显示一个对话框。
  3. 将“日志 级别 ”更改为“调试”。
  4. 指定日志文件的路 径和名称
    要在保存其他日志文件的同一目录中创建日志,请在“日志文件”属性中指定。./logs/<filename>。
  5. 将Logger更 改为 HTMLFormsPerfLogger ,然后单击“ 保存 ”。