调试HTML5表单

此文档包括几个疑难解答方案。 对于每种情况,都会提供一些步骤来解决问题。 按照以下步骤操作,如果问题仍然存在,请配置记录器以获取并查看日志中的错误/警告。 有关HTML5表单日志记录的详细信息,请参阅为HTML5表单生成日志

问题:呈现表单时,我会看到org.apache.sling.api.SlingException页

在异常详细信息中,搜索由​引起的单词

可能的原因是URL中的一个或多个参数不正确。

检查以下参数:

参数 描述
模板 模板的文件名
contentRoot 模板和关联资源所在的路径
dataRef 与模板合并的数据文件的绝对路径。
注意:路径定义数据文件的绝对路径。
数据 与模板合并的UTF-8编码数据字节。

问题:无法呈现表单(显示错误消息)

  1. 确保指定的参数正确。 有关参数的详细信息,请参阅渲染参数

  2. 登录到CRX包管理器(位于https://<server>:<port>/crx/packmgr/index.jsp),并检查以下包是否已正确安装:

    • adobe-lc-forms-content-pkg-<version>.zip
    • adobe-lc-forms-runtime-pkg-<version>.zip
  3. 登录到CQ Web控制台(Felix Console),网址为:https://<server>:<port>/system/console/bundles。

    确保以下捆绑包的状态为“活动”:

    • scala-lang.bundle [osgi]

    (com.adobe.livecyclescala-lang.bundle)

    • Adobe XFA Forms Renderer

    (com.adobe.livecycle.adobe-lc-forms-core)

    • Adobe XFA Forms LC连接器

    (com.adobe.livecycle.adobe-lc-forms-lc-connector)

问题:表单呈现时没有样式

  1. 在您的浏览器中,打开​开发人员工具。 确保用户档案.css可用。

  2. 如果用户档案.css文件不可用,请登录https://<server>:<port>/crx/de的CRX DE。

  3. 在左侧的文件夹层次结构中,导航到/etc/clientlibs/fd/xfaforms/。 打开文件夹中列出的css.txt文件。

    • 配置文件
    • 运行时
    • scrollnav
    • 工具栏
    • xfalib
  4. 验证css.txt中提及的文件是否在CRX DE lite中(位于/libs/fd/xfaforms/clientlibs/xfalib/css)。

    #base=css
    application.css
    dialog.css
    datepicker.css
    scribble.css
    listboxwidget.css
    
  5. 如果上述文件不可用,请再次安装adobe-lc-forms-runtime-pkg-<version>.zip包。

问题:遇到意外错误

  1. 在表单URL中,添加一个查询参数debugClientLibs并将其值设置为true(例如:https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<some path>&template=<name of xdp file>&log=1-a9-b9-c9&debugClientLibs=true)

  2. 在桌面浏览器(如chrome)中,转到“开发人员工具” — >“控制台”。

  3. 打开日志以标识错误类型。 有关日志的详细信息,请参阅HTML5表单](/docs/experience-manager-64/forms/html5-forms/enable-logs.html?lang=zh-Hans)的[日志。

  4. 转到“开发人员工具” — >“控制台”。 使用堆栈跟踪查找导致错误的代码。 调试错误以解决问题。

    注意

    如果脚本失败,请检查表单的PDF再现过程中是否也出现同样的问题。 如果是,则表单脚本逻辑中存在问题。

问题:无法提交表单

  1. 确保您有权访问AEM服务器,并且已连接到服务器。
  2. 检查参数submitUrl是否正确。
  3. 使用调试选项​1-a5-b5-c5​启用HTML5表单](/docs/experience-manager-64/forms/html5-forms/enable-logs.html?lang=zh-Hans)的[日志中所述的客户端日志。 然后渲染表单并单击“提交”。 打开浏览器调试控制台并检查是否有错误。
  4. 找到HTML5表单的日志中所述的服务器日志。 检查提交期间服务器日志中是否有错误。

问题:本地化的错误消息不显示

  1. 在桌面浏览器中使用附加的查询参数​debugClientLibs=true​渲染表单,然后转到“开发人员工具” — >“资源”并检查文件I18N.css。

  2. 如果文件不可用,请登录CRX DE,网址为https://<server>:<port>/crx/de。

  3. 在左侧的文件夹层次结构中,导航到/libs/fd/xfaforms/clientlibs/I18N并确保存在以下文件和文件夹:

    • Namespace.js
    • LogMessages.js
    • 语言文件夹
  4. 如果以上任何文件或文件夹不存在,请再次安装​adobe-lc-forms-runtime-pkg-<version>.zip​包。

  5. 导览至与区域设置名称同名的文件夹,并检查其内容。 文件夹必须包含以下文件:

    • I18N.js
    • js.txt
  6. 检查js.txt的内容,并确保它包含以下条目。

    ../Namespace.js
    I18N.js
    ../LogMessages.js
    

问题:图像未显示

  1. 确保图像URL正确。

  2. 检查您的浏览器是否支持此类图像。

  3. 在异常详细信息中,搜索由​引起的单词

    可能的原因是URL中的一个或多个参数不正确。

    检查以下参数:
    步骤文本

参数 描述
模板 模板的文件名
contentRoot 模板和关联资源所在的路径
dataRef 与模板合并的数据文件的绝对路径。
注意:路径定义数据文件的绝对路径。
数据 与模板合并的UTF-8编码数据字节。
  1. 在桌面浏览器中,转到“开发人员工具” — >“资源”。

    如果显示该图像,请在“帧”中选中左侧。

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now