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

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

导航至 AEMas a Cloud Service 选项卡。

按发布日期降序排序。

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

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

下载并提取最新信息 AEM Forms 存档适用于您的操作系统，来自 Software Distribution.

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

停止AEM实例，放置 AEM Forms 附加功能存档， aem-forms-addon-<version>.far，位于install文件夹中。

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

安装和配置Docker：

• (对于Microsoft® Windows)安装 Docker桌面. 它配置 Docker Engine 和 docker-compose 在你的电脑上。

• (Apple macOS)安装 适用于Mac的Docker Desktop. 它包括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 as a [Cloud Service] 项目： 创建 Experience Manager Forms as a [Cloud Service] 基于最新项目的项目 AEM原型 或更高版本。 原型可帮助开发人员轻松开始开发 AEM Forms as a Cloud Service。 它还包含一些示例主题和模板，可帮助您快速入门。

打开命令提示符并运行以下命令以创建 Experience Manager Forms as 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 Portal，请设置 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 Forms as a Cloud Service的环境。

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

导出自适应表单模板。

下载表单数据模型

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

• /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、主题和新SDK环境的PDF forms。

将自适应表单模板导入到新的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