启用HTML5表单的日志记录

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

配置服务器端日志记录

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

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

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

    Apace Sling日志记录器配置选项

  2. 将​日志级别​更改为​Debug

  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 日志被定向到浏览器Console
2 日志在客户端的JavaScript对象中收集,并可以发布到Server
3 以上两个选项

日志级别

日志级别 描述
0 关闭
3 致命
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
目标:服务器
xfa级别:INFO
xfaView级别:DEBUG
xfaPerf级别:TRACE
注意

每个日志类别a(xfa)、b(xfaView)和c(xfaPerf)的默认日志级别为2(ERROR)。 因此,对于日志配置:2-b6,不同类别的日志级别为:
a(xfa):2(默认级别错误)
b(xfaView):6(用户指定的TRACE)
a(xfaPerf):2(默认级别错误)

使用Configuration Manager启用日志记录

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

  1. https://'[server]:[port]'/system/console/configMgr登录到CQ配置管理器,然后使用管理员凭据登录。

  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. 将​日志级别​更改为Debug。

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

    注意

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

  5. 将​Logger​更改为​HTMLFormsPerfLogger​并单击​Save

在此页面上