開發AEM商務

根據Commerce Integration Framework (CIF)為AEM開發AEM專案會遵循與其他AEM專案相同的規則和最佳實務。 請先檢閱下列內容：

• AEM 6.5 Developing 使用指南
• AEM核心概念
• AEM開發 — 指導方針與最佳作法
• 如何使用Apache Maven建置AEM專案

AEM Commerce的本機開發

建議使用本機開發環境搭配CIF專案使用。

適用於AEM 6.5 aka的AEM Commerce附加元件。 CIF附加元件可用於本機開發，並以AEM套件的形式提供。 您可從以下網址下載： 軟體發佈入口網站 作為Feature Pack。

必要的軟體

下列專案應在本機安裝：

• 本機AEM 6.5
• AEM 6.5 Service Pack 7或更新版本
• Java 11
• Apache Maven (3.3.9 或更新版本)
• 節點LTS
• npm 6+
• Git

存取CIF附加元件

CIF附加元件可從 軟體發佈入口網站，搜尋「AEM Commerce附加元件」。

本機設定

對於使用AEM和CIF附加元件的本機CIF專案開發，請執行以下步驟：

1. 取得AEM 6.5版本並安裝AEM 6.5 Service Pack。 需要AEM 6.5 Service Pack 7，但Adobe建議安裝最後一個可用的Service Pack。

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

   java -jar <jar name> -unpack
   

3. 建立 crx-quickstart/install 資料夾

4. 將從軟體發佈入口網站下載的CIF附加元件所有套件複製到 crx-quickstart/install 資料夾。

1. 啟動AEM快速入門

透過OSGI主控台驗證設定： http://localhost:4502/system/console/osgi-installer. 此清單應包含與CIF附加元件相關的組合、內容套件和OSGI設定。 請確定所有套件組合都已啟動。

專案設定

有兩種方式可使用CIF啟動您的AEM Commerce專案。

使用AEM專案原型

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

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

例如：

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D aemVersion=6.5.5 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -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 Reference Store，只要複製 Git存放庫 並開始根據您的需求自訂專案。

將AEM連線至Commerce系統

若要將您的專案連線到商務系統，AEM必須設定為您的商務系統的GraphQL端點。

兩者皆是，由產生的專案 AEM專案原型 或 AEM Venia參考存放區，已包含 預設設定 而必須調整。

取代 url 在 com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json 與專案使用的商務系統的GraphQL端點搭配使用。

AEM Commerce附加元件和CIF核心元件會透過AEM伺服器並直接透過瀏覽器，連線至商務GraphQL端點。 使用者端CIF核心元件和CIF附加撰寫工具預設會連線至 /api/graphql. 如有需要，可透過CIFCloud Service設定調整此設定（請參閱下文）。

CIF附加元件提供GraphQL Proxy servlet，位於 /api/graphql. 如果您不打算使用本機AEM Dispatcher，建議一併設定GraphQL Proxy servlet。

導覽至http://localhost:4502/system/console/configMgr並為以下專案建立OSGI設定： Adobe CIF GraphQL Proxy Configuration 服務。 使用與上述用於GraphQL使用者端相同的商務系統GraphQL端點。

其他資源

• AEM 專案原型
• AEM Venia參考存放區

Business.Adobe.com 資源