在AEM 6.5 Forms上启用Headless自适应Forms enable-headless-adaptive-forms-on-aem-65-forms

Last update: Thu Jul 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
自适应表单

创建对象：

管理员

要在您的AEM 6.5 Forms环境中启用Headless自适应Forms，请设置一个基于AEM Archetype 41或更高版本的项目，并将其部署到您的所有创作和发布实例。

通过将基于AEM Archetype 41或更高版本的项目部署到AEM 6.5 Forms实例，您可以创建基于核心组件的自适应Forms。这些表单以JSON格式表示，用作Headful和Headless自适应Forms，从而允许在各种渠道（包括移动应用程序、Web和本机应用程序）中提供更大的灵活性和自定义设置。

先决条件 prerequisites

在AEM 6.5 Forms环境中启用Headless自适应Forms之前，

升级到AEM 6.5 Forms Service Pack 16 (6.5.16.0)或更高版本。
安装Apache Maven的最新版本。
安装纯文本编辑器。例如，Microsoft Visual Studio Code。

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

要创建基于AEM Archetype 41或稍后的项目并将其部署到所有创作实例和发布实例，请执行以下操作：

以管理员身份登录到您的计算机，托管并运行AEM 6.5 Forms实例。
打开命令提示符或终端。

运行以下命令可创建基于AEM Archetype 41的项目：

Microsoft Windows

code language-shell

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.23"`

   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.23"

Linux®或Apple macOS

code language-shell

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.23"`

   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.23"

执行上述命令时，请务必考虑以下事项：

更新命令以反映环境的特定值，包括appTitle、appId和groupId。此外，将includeFormsenrollment的值设置为y。如果您使用Forms Portal，请设置 includeExamples=y 选项以将Forms Portal核心组件包含在您的项目中。

（仅适用于基于Archetype版本41的项目）创建AEM Archetype项目后，请为基于核心组件的自适应Forms启用主题。要启用主题，请执行以下操作：

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

在第21行添加以下代码：

code language-xml

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>`

<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 行添加上述代码

保存并关闭该文件。

更新项目以包含最新版本的Forms核心组件：
1. 打开[AEM原型项目文件夹]/pom.xml进行编辑。
2. 将core.forms.components.version和core.forms.components.af.version的版本设置为最新的Forms核心组件版本。
3. 保存并关闭该文件。