启用自适应表单核心组件 enable-headless-adaptive-forms-on-aem-forms-cloud-service
在AEM Formsas a Cloud Service上启用自适应Forms核心组件后,您可以将AEM FormsCloud Service实例用于多个渠道,开始创建、发布和交付基于核心组件的自适应Forms和Headless Forms。 您需要具备启用了自适应表单核心组件的环境才能使用 Headless 自适应表单。
注意事项
-
创建全新的 AEM Forms as a Cloud Service 程序时,即已为您的环境启用自适应表单核心组件和 Headless 自适应表单。
-
如果您拥有的是其中未启用核心组件的旧版 Forms as a Cloud Service 程序,则您可将自适应表单核心组件依赖项添加到您的 AEM as a Cloud Service 存储库,并将该存储库部署到您的 Cloud Service 环境以启用 Headless 自适应表单。
-
如果您现有的Cloud Service环境提供了创建基于核心组件的自适应Forms的选项,则您的环境已启用了自适应Forms核心组件和Headless自适应Forms,并且您可以将基于核心组件的自适应Forms作为Headless表单提供给需要Adaptive Forms的Headless呈现的移动设备、Web、本机应用程序和服务。
启用自适应表单核心组件和 Headless 自适应表单 enable-headless-forms
按列出的顺序执行以下步骤,以便为 AEM Forms as a Cloud Service 环境启用自适应表单核心组件和 Headless 自适应表单
1. 克隆您的 AEM Forms as a Cloud Service Git 存储库 clone-git-repository
-
登录到 Cloud Manager 并选择您的组织和计划。
-
从您的 程序概述 页面导航到 管道 卡片,单击 访问存储库信息 按钮以访问和管理您的 Git 存储库。该页面包括以下信息:
- Cloud Manager Git 存储库的 URL。
- Git 存储库的凭据(用户名和密码)Git 用户名。
单击 生成密码 以查看或生成密码。
-
在本地计算机上打开终端或命令提示符并运行以下命令:
code language-shell git clone [Git Repository URL]
出现提示时,提供凭据。随后将该存储库克隆到您的本地计算机。
2. 将自适应表单核心组件依赖项添加到您的 Git 存储库 add-adaptive-forms-core-components-dependencies
-
在纯文本代码编辑器中打开您的 Git 存储库文件夹。例如 VS Code。
-
打开
[AEM Repository Folder]\pom.xml
文件以供编辑。 -
将
core.forms.components.version
、core.forms.components.af.version
和core.wcm.components.version
组件的版本替换为核心组件文档中指定的版本。如果不存在,请添加这些组件。code language-xml <!-- Replace the version with the latest released version at https://github.com/adobe/aem-core-forms-components/tags --> <properties> <core.wcm.components.version>2.22.10</core.wcm.components.version> <core.forms.components.version>2.0.18</core.forms.components.version> <core.forms.components.af.version>2.0.18</core.forms.components.af.version> </properties>
-
在
[AEM Repository Folder]\pom.xml
文件的依赖项部分中添加以下依赖项,然后保存该文件。code language-xml <!-- WCM Core Component Examples Dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <version>${core.wcm.components.version}</version> <type>zip</type> </dependency> <!-- End of WCM Core Component Examples Dependencies --> <!-- Forms Core Component Dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <!-- End of AEM Forms Core Component Dependencies -->
-
打开
[AEM Repository Folder]/all/pom.xml
文件以供编辑。在<embeddeds>
部分中添加以下依赖项,然后保存该文件。code language-xml <!-- WCM Core Component Examples Dependencies --> <!-- inside plugin config of filevault-package-maven-plugin --> <!-- embed wcm core components examples artifacts --> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <!-- embed forms core components artifacts --> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded>
note note NOTE 将 ${appId}
替换为您的 appId。要查找您的 ${appId}
,请在[AEM Repository Folder]/all/pom.xml
文件中搜索-packages/application/install
一词。在-packages/application/install
一词之前的文本就是您的${appId}
。例如,下列代码myheadlessform
是${appId}
。code language-none com.myheadlessform myheadlessform.ui.apps zip /apps/myheadlessform-packages/application install
-
在
[AEM Repository Folder]/all/pom.xml
文件的<dependencies>
部分中添加以下依赖项,然后保存该文件:code language-xml <!-- Other existing dependencies --> <!-- wcm core components examples dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> </dependency> <!-- forms core components dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> </dependency>
-
打开
[AEM Repository Folder]/ui.apps/pom.xml
以供编辑。添加af-core bundle
依赖项,然后保存该文件。code language-xml <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> </dependency>
note note NOTE 确保您的项目中不包含以下自适应表单核心组件工件。 <dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-apps</artifactId>
</dependency>
和 <dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-core</artifactId>
</dependency>
-
保存并关闭该文件。
3. 构建并部署更新后的代码
将更新后的代码部署到您的本地开发环境和 Cloud Service 环境,以便在这两个环境上启用核心组件:
构建更新后的代码并将其部署在本地开发环境上 core-components-on-aem-forms-local-sdk
-
打开命令提示符或终端。
-
导航到您的 Git 存储库项目的根目录。
-
运行以下命令以构建适合您环境的包:
code language-shell mvn clean install
成功构建该包后,可在 [Git Repository Folder]\all\target[appid].all-[version].zip 中找到它
-
使用包管理器将 [AEM Archetype Project Folder]\all\target[appid].all-[version].zip 包部署在本地开发环境上。
构建更新后的代码并将其部署在 AEM Forms as a Cloud Service 环境上 core-components-on-aem-forms-cs
-
打开终端或命令提示符。
-
导航到您的
[AEM Repository Folder]
,并按列出的顺序运行以下命令code language-shell git add pom.xml git add all/pom.xml git add ui.apps/pom.xml git commit -m "Added dependencies for Adaptive Forms Core Components" git push origin
-
将文件提交到 Git 存储库后,运行管道。
成功运行管道后,即为相应的环境启用自适应表单核心组件。此外,还将自适应表单(核心组件)模板和 Canvas 3.0 主题添加到您的 Forms as a Cloud Service 环境,并为您提供自定义和创建基于核心组件的自适应表单的选项。
常见问题解答 faq
什么是核心组件? core-components
核心组件是一组用于 AEM 的标准化 Web 内容管理 (WCM) 组件,以缩短您网站的开发时间并降低维护成本。
启用核心组件时将添加哪些功能? core-components-capabilities
为您的环境启用自适应表单核心组件时,将有一个空白的基于核心组件的自适应表单模板和 Canvas 3.0 主题添加到您的环境。为您的环境启用自适应表单核心组件后,您可以:
我的环境是否启用了自适应表单核心组件? enable-components
要查看是否为您的环境启用了自适应表单核心组件,请执行以下操作:
-
打开您的 AEM Forms Cloud Service Git 存储库的
[AEM Repository Folder]/all/pom.xml
文件。 -
搜索以下依赖项:
- core-forms-components-af-core
- core-forms-components-core
- core-forms-components-apps
- core-forms-components-af-apps
- core-forms-components-examples-apps
- core-forms-components-examples-content
如果存在依赖项,则为您的环境启用了自适应表单核心组件。