为HTML5表单创建自定义配置文件

配置文件是Apache Sling中的资源节点。 它表示HTML5表单演绎版服务的自定义版本。 您可以使用HTML5表单演绎版服务来自定义HTML5表单的外观、行为和交互。 JCR存储库的/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模块包含客户端库的引用。 它还描述了从请求中提取区域设置信息的方法,并在请求中包含本地化消息。 您可以在formRuntime.jsp中包含自己的customJavaScript库或样式。

config.jsp

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

toolbar.jsp

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

formBody.jsp

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

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

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

创建自定义配置文件

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

创建配置文件节点

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

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

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

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

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

创建配置文件渲染器脚本

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

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

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

  3. 在​hrform​文件夹中,创建名为​demo​的文件夹。

  4. 单击​Save All​按钮。

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

  6. 将​html.jsp​节点粘贴到上面创建的同名​html.jsp​的/apps/hrform/demo文件夹中,然后单击​保存

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

  8. 要验证是否创建了配置文件,请打开URL https://'[server]:[port]'/content/xfaforms/profiles/hrform.html

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

在此页面上