在AEM 6.5 Forms上啟用最適化Forms核心元件 enable-adaptive-forms-core-components
啟用最適化Forms核心元件可讓您從AEM 6.5 Forms環境開始建立、發佈及傳遞以核心元件為基礎的最適化Forms和無頭式最適化Forms。
若要在您的AEM 6.5 Forms環境中啟用最適化Forms核心元件,請在您的所有Author和Publish執行個體上設定和部署AEM Archetype 41或更新版本專案(啟用表單選項)。
本文提供在您的AEM 6.5 Forms環境中設定和部署AEM Archetype 41或更新版本專案,以啟用最適化Forms核心元件的詳細指示。 您可以參閱下列清單,以取得啟用Forms核心元件的 AEM 6.5 相容版本:
先決條件 prerequisites
在AEM 6.5 Forms環境中啟用最適化Forms核心元件之前:
-
安裝最新版的Apache Maven。
-
安裝純文字編輯器。 例如,Microsoft Visual Studio Code。
建立及部署最新的AEM原型專案
若要建立AEM Archetype 41或稍後型專案,並將其部署至您的所有作者和Publish執行個體:
-
以管理員身分登入電腦,託管並執行AEM 6.5 Forms執行個體。
-
開啟命令提示字元或終端機,然後執行下列命令以建立AEM Archetype專案(並啟用表單選項):
- Microsoft Windows
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.15"
- Linux或Apple macOS
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.15"
執行上述命令時,請務必考慮以下幾點:
-
請勿將
aemVersion
屬性的值從6.5.15.0
變更為其他值。 -
將
archetypeVersion
屬性設定為41
或更新版本。 如需最新版本,請參閱AEM Project Archetype檔案中的系統需求一節。 -
更新命令以反映您環境的特定值,包括
appTitle
、appId
和groupId
。 另外,將includeFormsenrollment
屬性的值設定為y
。 如果您使用Forms入口網站,請設定includeExamples=y
選項以在您的專案中包含Forms入口網站核心元件。
-
(僅適用於以Archetype版本41為基礎的專案)在AEM Archetype專案建立後,請為以核心元件為基礎的最適化Forms啟用主題。 若要啟用主題:
-
開啟[AEM原型專案資料夾]/ui.apps/src/main/content/jcr_root/apps/appId/components/adaptiveForm/page/customheaderlibs.html以進行編輯:
-
在第21行新增下列程式碼:
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>
行新增上述程式碼
-
儲存並關閉檔案。
-
-
更新專案以包含最新版Forms核心元件:
-
開啟[AEM原型專案資料夾]/pom.xml進行編輯。
-
將
core.forms.components.version
和core.forms.components.af.version
的版本設定為最新的Forms核心元件版本,並確認兩者版本與表格中提及的 Forms核心元件 相同,並設定core.wcm.components.version
的版本,如WCM核心元件所指定。note warning WARNING - 使用版本45建立Archetype專案時,
[AEM Archetype Project Folder]/pom.xml
一開始會將forms核心元件版本設定為1.1.28。在建立或部署Archetype專案之前,請將Forms核心元件版本更新為1.1.26。您可以在AEM 6.5 Forms版本記錄中找到最新版本。
note note NOTE - 如果您設定其他任何拓撲,請確定您將提交、預填和其他URL新增到Dispatcher層的允許清單。
- 使用版本45建立Archetype專案時,
-
儲存並關閉檔案。
-
-
成功建立AEM原型專案後,為您的環境建置部署套件。 若要建置套件:
-
導覽至AEM Archetype專案的根目錄。
-
執行以下命令,為您的環境建置AEM原型專案:
code language-shell mvn clean install
成功建置AEM Archetype專案後,會產生AEM套件。 您可以在[AEM原型專案資料夾]\all\target[appid].all-[version].zip中找到此套件
-
-
使用封裝管理員在所有Author和Publish執行個體上部署[AEM Archetype專案資料夾]\all\target[appid].all-[version].zip封裝。
- 如果您在存取發佈執行個體的登入對話方塊時遇到困難,若要透過封裝管理員安裝封裝,請嘗試使用URL:
http://[Publish Server URL]:[PORT]/system/console
登入。 這可讓您存取Publish執行個體的登入頁面,讓您繼續安裝程式。 - 將原型專案部署到您的環境後,請勿刪除或捨棄該專案。 Archetype專案需要將自訂和新的最適化Forms核心元件主題新增到您的環境。
核心元件已針對您的環境啟用。 將空白的Core Components based Adaptive Form範本和Canvas 3.0主題部署到您的環境,讓您能夠建立Core Components based Adaptive Forms。
常見問答
核心元件有哪些?
核心元件 是一組適用於 AEM 的標準化網站內容管理 (WCM) 元件,可加快開發時間並降低網站的維護成本。
啟用核心元件時新增了哪些功能?
當為您的環境啟用調適型表單核心元件時,一個以核心元件為主的調適型表單空白範本和 Canvas 3.0 主題會新增至您的環境中。為您的環境啟用調適型表單核心元件後,您可以:
- 建立以最適化Forms為基礎的核心元件。
- 建立以核心元件為基礎的最適化表單範本。
- 建立核心元件型最適化表單範本的自訂主題。
- 為行動、網路、原生應用程式等需要表單Headless呈現的管道和服務提供核心元件型最適化表單的JSON呈現。