在AEM 6.5 Forms上启用自适应Forms核心组件

上次更新: 2023-11-06
  • 创建对象:
  • Admin
    Developer
版本 文章链接
AEM as a Cloud Service 单击此处
AEM 6.5 本文

适用于: ✅用自适应表单核心组件❎自适应表单基础组件。

通过启用自适应Forms核心组件,您可以开始创建、发布和交付 基于核心组件的自适应FormsHeadless自适应Forms 从AEM 6.5 Forms环境中。

要在AEM 6.5 Forms环境中启用自适应Forms核心组件,请设置和部署 AEM Archetype 41或更高版本 基于所有创作和发布实例上的项目(启用了表单选项)。

本文介绍了如何在您的AEM 6.5 Forms环境中设置和部署基于AEM Archetype 41或更高版本的项目以启用自适应Forms核心组件。 您可以参阅下面的列表,以了解 AEM 6.5 用于启用Forms核心组件的兼容版本:

前提条件

在AEM 6.5 Forms环境中启用自适应Forms核心组件之前:

创建和部署最新的基于AEM原型的项目

创建AEM Archetype 41或 稍后 基于的项目并将其部署到所有创作和发布实例:

  1. 以管理员身份登录到您的计算机,托管并运行AEM 6.5 Forms实例。

  2. 打开命令提示符或终端,然后运行以下命令以创建AEM Archetype项目(启用表单选项):

    • Microsoft Windows
       mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate ^
       -D archetypeGroupId=com.adobe.aem ^
       -D archetypeArtifactId=aem-project-archetype ^
       -D archetypeVersion=41 ^
       -D appTitle="My Form" ^
       -D appId="myform" ^
       -D groupId="com.myform" ^
       -D includeFormsenrollment="y" ^
       -D aemVersion="6.5.15"
    
    • Linux或Apple macOS
       mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
       -D archetypeGroupId=com.adobe.aem \
       -D archetypeArtifactId=aem-project-archetype \
       -D archetypeVersion=41 \
       -D appTitle="My Form" \
       -D appId="myform" \
       -D groupId="com.myform" \
       -D includeFormsenrollment="y" \
       -D aemVersion="6.5.15"
    

    执行上述命令时,请务必考虑以下几点:

    • 不要更改的值 aemVersion 属性来源 6.5.15.0 任何事都可以。

    • 设置 archetypeVersion 属性至 41 或更高版本。 有关最新版本,请参阅系统要求部分,位于 AEM项目原型 文档。

    • 更新命令以反映环境的特定值,包括 appTitleappId、和 groupId. 此外,设置 includeFormsenrollment 属性至 y. 如果您使用Forms Portal,请设置 includeExamples=y 可在您的项目中包含的Forms Portal核心组件的选项。

  3. (仅适用于基于Archetype版本41的项目)创建AEM Archetype项目后,请为基于核心组件的自适应Forms启用主题。 要启用主题,请执行以下操作:

    1. 打开 [AEM原型项目文件夹]/ui.apps/src/main/content/jcr_root/apps/appId/components/adaptiveForm/page/customheaderlibs.html进行编辑:

    2. 在第21行添加以下代码:

      <sly data-sly-use.clientlib="core/wcm/components/commons/v1/templates/clientlib.html"
      data-sly-use.formstructparser="com.adobe.cq.forms.core.components.models.form.FormStructureParser"
      data-sly-test.themeClientLibRef="${formstructparser.themeClientLibRefFromFormContainer}">
      <sly data-sly-test="${themeClientLibRef}" data-sly-call="${clientlib.css @ categories=themeClientLibRef}"/>
      </sly>
      

      在第21行添加上述代码

    3. 保存并关闭该文件。

  4. 更新项目以包含最新版本的Forms核心组件:

    1. 打开 [AEM原型项目文件夹]/pom.xml进行编辑。

    2. 设置版本 core.forms.components.versioncore.forms.components.af.version最新Forms核心组件 版本并确保两者的版本都与 Forms核心组件 在表中提及,并设置版本 core.wcm.components.version 如中所述 WCM核心组件.

      警告
      • 使用创建原型项目时 version 45, [AEM原型项目文件夹]/pom.xml最初将forms核心组件版本设置为 1.1.28. 在构建或部署原型项目之前,请将表单核心组件版本更新为 1.1.26.
      注意
      • 如果设置了任何其他拓扑,请确保将提交、预填充和其他 URL 添加到 Dispatcher 层的允许列表。
    3. 保存并关闭该文件。

  5. 成功创建AEM原型项目后,为您的环境构建部署包。 要构建包,请执行以下操作:

    1. 导航到AEM Archetype项目的根目录。

    2. 运行以下命令为您的环境构建AEM原型项目:

      mvn clean install
      

      archetypebuild-success

    成功构建AEM原型项目后,将生成AEM包。 您可以在以下位置找到该包: [AEM原型项目文件夹]\all\target[appid].all-[版本].zip

  6. 使用 包管理器 以部署 [AEM原型项目文件夹]\all\target[appid].all-[版本].zip包。

注意
  • 如果您在发布实例上访问登录对话框时遇到困难,要通过包管理器安装包,请尝试使用URL: http://[Publish Server URL]:[PORT]/system/console 以登录。 这允许您访问发布实例的登录页面,从而允许您继续安装过程。
  • 将原型项目部署到您的环境后,请勿将其删除或放弃。 要将自定义主题和新的自适应Forms核心组件主题添加到您的环境中,需要原型项目。

为您的环境启用了核心组件。 将基于空白核心组件的自适应表单模板和画布3.0主题部署到您的环境,使您能够 创建基于核心组件的自适应Forms.

常见问题解答

什么是核心组件?

核心组件是一组用于 AEM 的标准化 Web 内容管理 (WCM) 组件,以缩短您网站的开发时间并降低维护成本。

在启用核心组件上添加了哪些功能?

为您的环境启用自适应表单核心组件时,将有一个空白的基于核心组件的自适应表单模板和 Canvas 3.0 主题添加到您的环境。为您的环境启用自适应表单核心组件后,您可以:

  • 创建基于核心组件的自适应表单。
  • 创建基于核心组件的自适应表单模板。
  • 为基于核心组件的自适应表单模板创建自定义主题。
  • 可以将基于核心组件的自适应表单的 JSON 表示形式提供给需要表单的 Headless 表示形式的移动、Web、原生应用程序和服务等渠道。

后续内容

在此页面上