调试HTML5表单 debugging-html-forms
本文档包括若干疑难解答情景。 对于每种情况,都提供了一些步骤来解决问题。 按照这些步骤操作,如果问题仍然存在,请配置记录器以获取并查看日志,以获取错误/警告。 有关HTML5表单日志记录的更多详细信息,请参阅 为HTML5表单生成日志.
问题:呈现表单时,我看到org.apache.sling.api.SlingException页面 problem-when-rendering-the-form-i-see-org-apache-sling-api-slingexception-exception-page
在例外详细信息中,搜索单词 由.
可能的原因是URL中的一个或多个参数不正确。
检查以下参数:
问题:无法呈现表单(显示错误消息) problem-unable-to-render-a-form-an-error-message-is-displayed
-
确保指定的参数正确无误。 有关参数的详细信息,请参阅 呈现参数.
-
登录到CRX包管理器(位于https://)<server>:<port>/crx/packmgr/index.jsp)并检查以下包是否正确安装:
- adobe-lc-forms-content-pkg-<version>.zip
- adobe-lc-forms-runtime-pkg-<version>.zip
-
登录到CQ Web控制台(Felix Console),网址为https://<server>:<port>/system/console/bundles。
确保以下包的状态为“活动”:
- scala-lang.bundle [osgi]
(com.adobe.livecyclescala-lang.bundle)
- AdobeXFA Forms渲染器
(com.adobe.livecycle.adobe-lc-forms-core)
- AdobeXFA Forms LC连接器
(com.adobe.livecycle.adobe-lc-forms-lc-connector)
问题:表单呈现时不带样式 problem-form-renders-without-styles
-
在浏览器中,打开 开发人员工具. 确保profile.css可用。
-
如果profile.css文件不可用,请通过https://登录CRX DE<server>:<port>/crx/de.
-
在左侧的文件夹层次结构中,导航到/etc/clientlibs/fd/xfaforms/。 打开文件夹中列出的css.txt文件。
- 侧面像
- 运行时
- 滚动导航
- 工具栏
- xfalib
-
验证css.txt中提及的文件是否存在于CRX DE Lite中的/libs/fd/xfaforms/clientlibs/xfalib/css。
code language-css #base=css application.css dialog.css datepicker.css scribble.css listboxwidget.css
-
如果上述文件不可用,请安装adobe-lc-forms-runtime-pkg-<version>.zip包。
问题:遇到意外错误 problem-unexpected-error-encountered
-
在表单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)
-
在桌面浏览器(如chrome)中,转到开发人员工具 — >控制台。
-
打开日志以标识错误类型。 有关日志的详细信息,请参阅 HTML5表单日志.
-
转到“开发人员工具” — >“控制台”。 使用堆栈跟踪来查找导致错误的代码。 调试错误以解决问题。
note note NOTE 如果脚本编写失败,请检查表单的PDF呈现过程中是否也出现相同的问题。 如果是,则表单脚本逻辑中出现问题。
问题:无法提交表单 problem-unable-to-submit-the-form
- 确保您有权访问AEM服务器,并且已连接到服务器。
- 检查参数submitUrl是否正确。
- 按照 HTML5表单的日志 使用调试选项作为 1-a5-b5-c5. 然后渲染表单并单击提交。 打开浏览器调试控制台并检查是否出错。
- 按照 HTML5表单的日志. 检查提交期间服务器日志中是否存在任何错误。
问题:未显示本地化的错误消息 problem-localized-error-messages-do-not-display
-
使用附加查询参数渲染表单 debugClientLibs=true 在桌面浏览器中,然后转到“开发人员工具” — >“资源”并检查文件I18N.css。
-
如果文件不可用,请通过https://登录CRX DE<server>:<port>/crx/de.
-
在左侧的文件夹层次结构中,导航到/libs/fd/xfaforms/clientlibs/I18N,并确保存在以下文件和文件夹:
- Namespace.js
- LogMessages.js
- 语言文件夹
-
如果以上任何文件或文件夹不存在,请安装 adobe-lc-forms-runtime-pkg-<version>.zip 包。
-
导航到与区域设置名称同名的文件夹,并检查其内容。 文件夹必须包含以下文件:
- I18N.js
- js.txt
-
检查js.txt的内容,并确保其包含以下条目。
code language-none ../Namespace.js I18N.js ../LogMessages.js
问题:未显示图像 problem-image-not-showing-up
-
确保图像URL正确。
-
检查您的浏览器是否支持此类图像。
-
在例外详细信息中,搜索单词 由.
可能的原因是URL中的一个或多个参数不正确。
检查以下参数:步骤文本
-
在桌面浏览器中,转到“开发人员工具” — >“资源”。
如果显示图像,请在“帧”中检查左侧。