啟用最適化Forms核心元件 enable-headless-adaptive-forms-on-aem-forms-cloud-service
在AEM Formsas a Cloud Service上啟用最適化Forms核心元件,可讓您開始建立、發佈和提供核心元件式的最適化Forms和Headless Forms,並使用AEM FormsCloud Service例項來將您的傳送至多個管道。 您需要啟用調適型表單核心元件的環境才能使用 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表單提供給需要最適化Forms的Headless呈現形式的行動裝置、網頁、原生應用程式和服務等管道。
啟用調適型表單核心元件和 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 以您的 appld 取代 ${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 存放庫資料夾]\all\target[appid].all-[version].zip 中找到套件
-
使用套件管理員,在本機開發環境中部署 [AEM Archetype 專案資料夾]\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 的標準化網站內容管理 (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
若相依性存在,表示系統已為您的環境啟用調適型表單核心元件。