为AEM Forms设置本地开发环境 overview

使用您的Adobe ID登录https://experience.adobe.com/#/downloads

导航到​ AEM as a Cloud Service ​选项卡。

按发布日期降序排序。

单击最新的Adobe Experience Manager as a Cloud Service SDK、Experience Manager Forms功能存档(AEM Forms加载项)、表单引用资源或Forms Designer。

查看并接受EULA。 选择​ 下载 ​按钮。

从Software Distribution下载并提取操作系统的最新AEM Forms存档。

导航到crx-quickstart/install目录。 如果该文件夹不存在，请创建它。

停止AEM实例，将AEM Forms加载项功能存档aem-forms-addon-<version>.far放入安装文件夹中。

转到活动命令窗口并按Ctrl + C命令以重新启动SDK。

安装和配置Docker：

• (对于Microsoft® Windows)安装Docker桌面。 它在您的计算机上配置Docker Engine和docker-compose。

• (Apple macOS)安装Docker Desktop for Mac。 它包括Docker引擎、Docker CLI客户端、Docker撰写、Docker内容信任、Kubernetes和凭据帮助程序。

• (对于Linux®)在您的计算机上安装Docker引擎和Docker合成。

创建文件夹（例如aem-sdk）与创作实例和发布实例并行进行。 例如，C:\aem-sdk。

提取aem-forms-addon-<version>.zip\aem-forms-addon-native-<version>.zip文件。

创建环境变量AEM_HOME ，并指向本地AEM Author安装。 例如，C:\aem\author\。

打开sdk.bat或sdk.sh进行编辑。 将AEM_HOME设置为指向本地AEM Author安装。 例如，C:\aem\author\。

打开命令提示符并导航到aem-forms-addon-native-<version>文件夹。

确保您的本地AEM创作实例已启动并正在运行。 运行以下命令以启动SDK：

• 在Microsoft® Windows上

  code language-shell
  sdk.bat start

• Linux®或Apple macOS

  code language-shell
  % export AEM_HOME=[local AEM Author installation] % ./sdk.sh start

在本地开发实例上克隆Cloud Manager Git存储库： ​您的Cloud Manager Git存储库包含默认的AEM项目。 它基于AEM原型。 使用Cloud Manager UI中的自助Git帐户管理克隆Cloud Manager Git存储库，以将项目引入本地开发环境。 有关访问存储库的详细信息，请参阅访问存储库。

创建Experience Manager Forms作为[Cloud Service]项目： ​根据最新的AEM原型或更高版本，创建Experience Manager Forms作为[Cloud Service]项目。 原型可帮助开发人员轻松开始开发AEM Formsas a Cloud Service。 它还包含一些示例主题和模板，可帮助您快速入门。

打开命令提示符并运行以下命令以创建Experience Manager Formsas a Cloud Service项目。

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=mysite -D appId=mysite -D groupId=com.mysite -D includeFormsenrollment="y" -D aemVersion="cloud"

更改上述命令中的appTitle、appId和groupId以反映您的环境。 此外，根据您的许可证和要求，将includeFormsenrollment、includeFormscommunications和includeFormsheadless的值设置为y或n。 要基于核心组件创建自适应Forms，必须使用includeFormsheadless。

• 使用includeFormsenrollment=y选项可包含创建自适应Forms所需的特定于Forms的配置、主题、模板、核心组件和依赖项。 如果您使用Forms门户，请设置includeExamples=y选项。 它还将Forms Portal核心组件添加到项目中。

• 使用includeFormscommunications=y选项可以包含客户通信功能所需的Forms核心组件和依赖项。

  note warning
  WARNING
  使用版本45创建原型项目时，[AEM原型项目文件夹]/pom.xml最初将Forms核心组件版本设置为2.0.64。在构建或部署原型项目之前，请将Forms核心组件版本更新为2.0.62。

将项目部署到您的本地开发环境。 您可以使用以下命令部署到本地开发环境

mvn -PautoInstallPackage clean install

有关命令的完整列表，请参阅生成和安装

将代码部署到您的 AEM Forms as a Cloud Service环境。

打开您的AEM项目并导航到\src\conf.dispatcher.d\available_farms

创建default.farm文件的副本。 例如：forms.farm。

打开创建的forms.farm文件进行编辑并替换以下代码：

#/ignoreUrlParams {
#/0001 { /glob "*" /type "deny" }
#/0002 { /glob "q" /type "allow" }
#}

替换为

/ignoreUrlParams {
/0001 { /glob "*" /type "deny" }
/0002 { /glob "dataRef" /type "allow" }
}

保存并关闭文件。

转到conf.d/enabled_farms并创建指向forms.farm文件的符号链接。

编译项目并将其部署到您的AEM Formsas a Cloud Service环境。

下载自适应Forms、主题和PDF forms。

导出自适应表单模板。

下载表单数据模型

导出可编辑的模板、云配置和工作流模型。 要从现有SDK中导出前面提到的所有项目，请创建包含以下过滤器的CRX-Package：

• /conf/ReferenceEditableTemplates
• /conf/global/settings/cloudconfigs
• /conf/global/settings/wcm
• /var/workflow/model
• /conf/global/settings/workflow

从本地开发环境导出电子邮件配置、提交和预填充操作代码。 要导出这些设置和配置，请在本地开发环境中创建以下文件夹和文件的副本：

• [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
• [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
• [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

将自适应Forms、主题和PDF forms导入新SDK环境。

将自适应表单模板导入到新的SDK环境。

将表单数据模型上传到新的SDK环境。

导入可编辑的模板、云配置和工作流模型。 要导入新SDK环境中前面提到的所有项目，请将包含这些项目的CRX包导入到新SDK环境中。

从本地开发环境导入电子邮件配置、提交和预填充操作代码。 要导入这些设置和配置，请将以下文件从旧的原型项目放置到新原型项目中：

• [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
• [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
• [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config