在AEM 6.5 Forms上启用自适应Forms核心组件 enable-adaptive-forms-core-components

版本
文章链接
AEM as a Cloud Service
单击此处
AEM 6.5
本文

启用自适应Forms核心组件允许您从AEM 6.5 Forms环境开始创建、发布和交付基于核心组件的自适应FormsHeadless自适应Forms

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

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

先决条件 prerequisites

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

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

要创建基于AEM Archetype 41或稍后的项目并将其部署到您的所有Author和Publish实例:

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

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

    • Microsoft Windows
    code language-shell
       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
    code language-shell
       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项目原型文档中的系统要求部分。

    • 更新命令以反映环境的特定值,包括appTitleappIdgroupId。 此外,将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行添加以下代码:

      code language-xml
      <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核心组件中所提供。

      note warning
      WARNING
      • 使用版本45创建Archetype项目时,[AEM Archetype Project Folder]/pom.xml最初将forms核心组件版本设置为1.1.28。在构建或部署原型项目之前,请将Forms核心组件版本更新为1.1.26。您可以在AEM 6.5 Forms版本历史记录中找到最新版本。
      note note
      NOTE
      • 如果设置了任何其他拓扑,请确保将提交、预填充和其他 URL 添加到 Dispatcher 层的允许列表。
    3. 保存并关闭该文件。

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

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

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

      code language-shell
      mvn clean install
      

      archetypebuild-success

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

  6. 使用包管理器在所有Author和Publish实例上部署[AEM项目文件夹]\all\target[appid].all-[version].zip包。

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

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

常见问题解答

什么是核心组件?

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

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

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

  • 创建基于核心组件的自适应Forms。
  • 创建基于核心组件的自适应表单模板。
  • 为基于核心组件的自适应表单模板创建自定义主题。
  • 向需要表单Headless表示的渠道(如移动设备、Web、本机应用程序和服务)提供基于核心组件的自适应表单的JSON表示。

后续内容

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2