設定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)安裝適用於Mac的Docker Desktop。 它包括Docker引擎、Docker CLI客戶端、Docker撰寫、Docker內容信任、Kubernetes和Credential Helper。

• (適用於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 Author執行個體已啟動且在執行中。 執行以下命令以啟動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 Archetype為基礎。 從Cloud Manager UI使用自助Git帳戶管理功能來複製您的Cloud Manager Git存放庫，以將專案引進您的本機開發環境中。 如需存取存放庫的詳細資訊，請參閱存取存放庫。

將Experience Manager Forms建立為[Cloud Service]專案： ​根據最新的AEM Archetype或更新版本，將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。 includeFormsheadless是根據核心元件建立最適化Forms的必要元件。

• 使用includeFormsenrollment=y選項來包含建立Adaptive Forms所需的Forms特定設定、主題、範本、核心元件和相依性。 如果您使用Forms入口網站，請設定includeExamples=y選項。 它也會將Forms Portal核心元件新增至專案。

• 使用includeFormscommunications=y選項加入Forms核心元件和加入客戶通訊功能所需的相依性。

  note warning
  WARNING
  使用版本45建立Archetype專案時，[AEM Archetype專案資料夾]/pom.xml一開始會將Forms核心元件版本設定為2.0.64。在建立或部署Archetype專案之前，請將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