為AEM as a Cloud Service開發AEM Commerce develop

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
商務整合框架

建立對象：

管理員

根據AEM as a Cloud Service的Commerce integration framework(CIF)開發AEM Commerce專案，會遵循與AEM as a Cloud Service上的其他AEM專案相同的規則和最佳實務。請先檢閱下列內容：

使用AEM as a Cloud Service SDK進行本機開發 local

https://video.tv.adobe.com/v/39476/?quality=12&learn=on

建議使用本機開發環境搭配CIF專案使用。為AEM as a Cloud Service提供的CIF附加元件也可用於本機開發。可從軟體發佈入口網站下載。

CIF附加元件以Sling功能封存的形式提供。軟體發佈入口網站上的zip檔案包含兩個Sling功能封存檔案，一個用於AEM作者，另一個用於AEM發佈執行個體。

AEM as a Cloud Service 的新手嗎？ 檢視使用AEM as a Cloud Service SDK設定本機開發環境的詳細指南。

必要的軟體

下列專案應在本機安裝：

存取CIF附加元件

可以從軟體發佈入口網站下載CIF附加元件的ZIP檔案。 Zip檔案包含CIF附加元件做為 Sling功能封存，它不是AEM套件。可使用AEM as a Cloud Service授權存取SDK清單。

TIP

請務必使用最新的CIF附加元件版本。

本機設定

對於使用AEM as a Cloud Service SDK的本機CIF附加元件開發，請執行以下步驟：

取得最新的AEM as a Cloud Service SDK

解壓縮AEM .jar，以便建立crx-quickstart資料夾，請執行：

code language-bash
`java -jar <jar name> -unpack`

建立crx-quickstart/install資料夾
將CIF附加元件的正確Sling功能封存檔案複製到crx-quickstart/install資料夾。

CIF附加元件zip檔案包含兩個Sling功能封存.far檔案。請務必針對AEM Author或AEM Publish使用正確的套裝，端視您計畫執行本機AEM as a Cloud Service SDK的方式而定。

建立名為COMMERCE_ENDPOINT的本機OS環境變數，其中包含Adobe Commerce GraphQL端點。

macOS X範例：

code language-bash
`export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql`

範例Windows：

code language-bash
`set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql`

AEM使用此變數來連線至您的商務系統。此外，CIF附加元件包含本機反向Proxy，可讓Commerce GraphQL端點在本機可用。此Proxy由CIF編寫工具（產品主控台和選擇器）使用，並用於執行直接GraphQL呼叫的CIF使用者端元件。

此外，亦必須針對AEM as a Cloud Service環境設定此變數。如需變數的詳細資訊，請參閱為AEM as a Cloud Service設定OSGi。

（選用）若要啟用分階段目錄功能，您必須為Adobe Commerce執行個體建立整合權杖。請依照快速入門中的步驟來建立權杖。

將名稱為COMMERCE_AUTH_HEADER的OSGi密碼設定為下列值：

code language-xml
`Authorization: Bearer <Access Token>`

如需秘密的詳細資訊，請參閱為AEM as a Cloud Service設定OSGi。

啟動AEM as a Cloud Service SDK

NOTE

請務必在步驟5中設定環境變數的相同終端機視窗中啟動AEM as a Cloud Service SDK。如果您在單獨的終端機視窗中啟動它，或連按兩下.jar檔案，請確定環境變數是可見的。

透過OSGI主控台驗證安裝： http://localhost:4502/system/console/osgi-installer。此清單應包含功能模型檔案中定義的CIF附加元件相關組合、內容套件和OSGI設定。

專案設定 project

針對AEM as a Cloud ServiceBootstrapCIF專案有兩種方式。

使用AEM專案原型

AEM專案原型是Bootstrap預先設定的專案以開始使用CIF的主要工具。 CIF核心元件和所有的必要設定都可包含在產生專案中，並提供一個額外選項。

TIP

請一律使用最新版的AEM Project Archetype，以便產生專案。

請參閱AEM專案原型使用指示，瞭解如何產生AEM專案。若要將CIF納入專案中，請使用includeCommerce選項。

例如：

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=35 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D includeCommerce=y

CIF核心元件可透過包含提供的all套件或單獨使用CIF內容套件和相關OSGI套件組合來用於任何專案。若要手動將CIF核心元件新增至專案，請使用下列相依性：

<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-apps</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-config</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-core</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>graphql-client</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>magento-graphql</artifactId>
    <version>x.y.z</version>
</dependency>

使用AEM Venia Reference Store

啟動CIF專案的第二個選項是複製並使用AEM Venia參考存放區。 AEM Venia Reference Store是範例參考店面應用程式，可示範AEM的CIF核心元件的使用情形。其目的是作為一組最佳實務範例，以及開發您自己的功能的潛在起點。

若要開始使用Venia參考存放區，請複製Git存放庫，並開始根據您的需求自訂專案。

NOTE

Venia Reference Store專案包含AEM as a Cloud Service和AEM 6.5的兩個組建設定檔。請檢查專案readme.md，以便瞭解其使用方式。

其他資源

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab