创建HTML5表单的自定义用户档案

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

用户档案节点具 有sling:resourceSuperType 属性,默认值 为xfaforms/用户档案。 节点的渲染脚本位于/libs/xfaforms/用户档案。

Sling脚本是JSP脚本。 这些JSP脚本用作容器,将请求表单的HTML和所需的JS/CSS对象组合在一起。 这些Sling脚本也称为 用户档案渲染器脚本。 用户档案呈现器调用Forms OSGi服务来呈现所请求的表单。

用户档案脚本为GET和POST请求的html.jsp和html.POST.jsp。 您可以复制和修改一个或多个文件以覆盖和添加您的自定义项。 不要进行任何就地更改,修补程序更新会覆盖此类更改。

用户档案包含各种模块。 模块包括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/用户档案

  3. 复制节点默认值,并将节点粘贴到名为hrform的​不同文件夹(/content/ 用户档案)中

  4. 选择新节点 hrform,并添加字符串属性: sling:resourceType with value: hrform/demo

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

创建用户档案渲染器脚本

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

  1. 在左窗格中,导览至该文 /apps 件夹。

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

  3. 在hrform文 件夹 中,创建一个名为demo的 文件夹

  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服务器作者实例 上预览表单。

在此页面上