为HTML5表单创建自定义配置文件 creating-a-custom-profile-for-html-forms

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

用户档案是 Apache Sling. 它表示HTML5表单呈现服务的自定义版本。 您可以使用HTML5表单呈现服务来自定义HTML5表单的外观、行为和交互。 中存在配置文件节点 /content 文件夹。 您可以将节点直接放置在 /content 文件夹或任何子文件夹 /content 文件夹。

配置文件节点具有 sling:resourceSuperType 属性,默认值为 xfaforms/profile. 节点的渲染脚本位于/libs/xfaforms/profile。

Sling脚本是JSP脚本。 这些JSP脚本用作容器,用于将请求表单的HTML和所需的JS/CSS工件放在一起。 这些Sling脚本也称为 配置文件渲染器脚本。 配置文件渲染器调用Forms OSGi服务来渲染请求的表单。

配置文件脚本位于html.jsp和html.POST.jsp中,用于GET和POST请求。 您可以复制和修改一个或多个文件以覆盖和添加您的自定义设置。 不要进行任何就地更改,修补程序更新将覆盖此类更改。

用户档案包含各种模块。 这些模块包括formRuntime.jsp、config.jsp、toolbar.jsp、formBody.jsp、nav_footer.jsp和footer.jsp。

formRuntime.jsp formruntime-jsp-br

formRuntime.jsp模块包含客户端库的引用。 它还描述了从请求中提取区域设置信息的方法,并在请求中包含本地化消息。 您可以在formRuntime.jsp中包含自己的自定义javascript库或样式。

config.jsp config-jsp

config.jsp模块包含各种配置,如日志记录、代理服务和行为版本。 您可以向config.jsp模块添加您自己的配置和小组件自定义。 您还可以将自定义小组件注册等配置添加到config.jsp模块。

toolbar.jsp toolbar-jsp

toolbar.jsp包含用于创建彩色工具栏的代码。 要删除工具栏,请从HTML.jsp中删除toolbar.jsp

formBody.jsp formbody-jsp

formBody.jsp模块用于XFA表单的HTML表示。

起初,HTML5表单仅呈现表单的第一页。 当用户滚动表单时,将加载其余表单。 它可加快加载体验的速度。 nav_footer.jsp组件包含所有样式和所需元素,以便于在滚动时加载页面。

footer.jsp footer-jsp

footer.jsp模块为空。 它允许您添加仅用于用户交互的脚本。

创建自定义用户档案 creating-custom-profiles

要创建自定义配置文件,请执行以下步骤:

创建配置文件节点 create-profile-node

  1. 导航到位于URL的CRX DE界面: https://[server]:[port]/crx/de 并使用管理员凭据登录到界面。

  2. 在左窗格中,导航到相应位置 /content/xfaforms/profiles.

  3. 复制默认节点,并将该节点粘贴到不同的文件夹(/content/profiles) hrform.

  4. 选择新节点, hrform,然后添加字符串属性: sling:resourceType 值: hrform/demo.

  5. 单击工具栏菜单中的全部保存,以保存更改。

创建配置文件渲染器脚本 create-the-profile-renderer-script

创建自定义配置文件后,向此配置文件添加渲染信息。 在收到对新配置文件的请求时,CRX会验证要呈现的JSP页是否存在/apps文件夹。 在/apps文件夹中创建JSP页。

  1. 在左窗格中,导航到 /apps 文件夹。

  2. 右键单击 /apps 文件夹,然后选择创建名为的文件夹 hrform.

  3. 内部 hrform 文件夹创建名为的文件夹 演示.

  4. 单击 全部保存 按钮。

  5. 导航到 /libs/xfaforms/profile/html.jsp 复制节点 html.jsp.

  6. 粘贴 html.jsp 节点 /apps/hrform/demo 在上面创建的文件夹具有相同名称 html.jsp 单击 保存.

  7. 如果您有配置文件脚本的任何其他组件,请按照步骤1-6复制/apps/hrform/demo文件夹中的组件。

  8. 要验证是否创建了用户档案,请打开URL https://[server]:[port]/content/xfaforms/profiles/hrform.html

要验证您的表单, 导入表单 从本地文件系统到AEM Forms 预览表单 在AEM服务器创作实例上。

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da