为HTML5表单启用日志记录 enable-logging-for-html-forms
您可以配置记录器实用程序,以开始创建HTML5表单的日志。 记录器实用程序有各种级别,您可以根据需要设置一个级别。 HTML5表单包含服务器和客户端组件。 您可以为两个组件配置日志。
配置服务器端日志记录 configuring-server-side-logging
执行以下步骤以配置服务器端日志:
-
转到
https://'[server]:[port]'/system/console/configMgr
。 找到并打开 Apace Sling日志记录器配置 选项。 此时将显示一个对话框:Apace Sling日志记录器配置选项
-
将 日志级别 更改为 调试。
-
指定 日志文件 的名称和路径。
note note NOTE 要在HTML5表单log目录中生成日志,请在文件名之前添加……/logs/ 。 -
将 记录器 更改为 HTMLFormsPerfLogger。 单击 保存。
配置客户端日志记录 configuring-client-logging
可以使用以下方法在HTML5表单中启用客户端日志记录:
- 使用名为
log
的请求参数 - 使用CQ Configuration Manager
使用请求参数启用日志记录 enabling-logging-using-request-parameter
使用此方法,可以为特定请求生成日志。 请求参数的名称为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>.
日志配置由日志级别和记录器类别组成。
日志目标 log-destination
日志级别 log-levels
记录器类别 logger-categories
日志配置 log-configuration
在日志URL中,日志配置查询字符串参数的定义如下:
{destination}-{a level}-{b level}-{c level}
例如:
a (xfa):2(默认级别错误)
b (xfaView):6(用户指定的TRACE)
a (xfaPerf):2(默认级别错误)
使用Configuration Manager启用记录 enabling-logging-using-configuration-manager
如果使用Configuration Manager启用日志记录,则会为每个渲染请求生成日志,直到再次禁用日志记录为止。
-
登录到
https://'[server]:[port]'/system/console/configMgr
上的CQ配置管理器并使用管理员凭据登录。 -
搜索并单击 Mobile Forms配置。
-
在“调试选项”文本框中,按照上一节中的说明输入日志配置,例如 2-a4-b5-c6
表单配置
上传日志 uploading-logs
如果目标设置为1,则所有客户端脚本日志消息都将定向到控制台。 如果管理员需要这些日志以及服务器日志,请将目标级别设置为2。 在此级别,所有日志都收集在客户端的JS对象中,如果使用默认配置文件呈现表单,则工具栏中的 突出显示现有字段 按钮左侧将显示 发送日志 按钮。 当用户单击该链接时,所有收集的日志都将发布到服务器,并记录在服务器上配置的错误日志文件中。
默认情况下,所有信息都会添加到/crx-repository/logs/目录下的error.log文件中。
要更改日志文件的位置和名称,请执行以下操作:
-
以管理员身份登录Configuration Manager。 配置管理器的默认URL为
https://'[server]:[port]'/system/console/configMgr
。 -
单击 Apache Sling日志记录器配置。 将显示一个对话框。
-
将 日志级别 更改为Debug。
-
指定 日志文件 的路径和名称。
note note NOTE 要在保留其他日志文件的同一目录中创建日志,请在“日志文件”属性中指定……/logs/<filename>。 -
将 记录器 更改为 HTMLFormsPerfLogger,然后单击 保存。