AEM Commerce as aCloud Service快速入門

若要開始以AEM Commerce as aCloud Service的形式使用,您的Experience Manager Cloud Service必須布建Commerce Integration Framework(CIF)附加元件。 CIF附加元件是位於AEM Sites上方的額外模組,作為Cloud Service

入門

AEM Commerce as a Cloud Service的上線程式為兩個步驟:

  1. 啟用AEM Commerce as a Commerce ,並布建CIF附加元件
  2. 將AEM Commerce作為Cloud Service與您的商務解決方案連結

第一步上線步驟由Adobe完成。 如需定價和布建的詳細資訊,您需要聯絡您的銷售代表。

布建CIF附加元件後,該元件即會套用至任何現有的Cloud Manager程式。 如果您沒有Cloud Manager計畫,則需要建立新計畫。 有關詳細資訊,請參閱設定程式

第二步是針對每個AEM做為Cloud Service環境進行自助服務。 CIF附加元件初次布建後,您還需要執行一些額外設定。

將AEM與Commerce解決方案連結

若要將CIF附加元件和AEM CIF核心元件與商務解決方案連結,您需透過Cloud Manager環境變數提供GraphQL端點URL。 變數名稱為COMMERCE_ENDPOINT。 必須配置通過HTTPS的安全連接。

此環境變數會用於兩個位置:

  • 從AEM到商務後端的GraphQL呼叫,透過AEM CIF核心元件和客戶專案元件使用的一些通用共用GraphQl用戶端。
  • 在每個AEM環境上設定變數的GraphQL代理URL ,此變數可在/api/graphql取得。 AEM商務製作工具(CIF附加元件)和CIF用戶端元件都會使用此功能。

每個AEM都可以使用不同的GraphQL端點URL作為Cloud Service環境。 如此,專案便可將AEM預備環境與商務預備系統和AEM生產環境連結至商務生產系統。 該GraphQL端點必須可公開使用,不支援專用VPN或本地連接。 可選地,可提供驗證頭以使用需要驗證的其他CIF功能。

選用,且僅適用於AdobeCommerce Enterprise / Cloud,CIF附加元件支援為AEM作者使用分段目錄資料。 這需要設定授權Token。 基於安全考量,已設定的授權Token僅可供使用,且用於AEM製作執行個體。 AEM發佈例項無法顯示分階段資料。

有兩個選項可設定端點:

透過Cloud Manager UI(預設)

您可以使用「環境詳細資訊」頁面上的對話方塊來完成此作業。 查看啟用Commerce的程式的此頁時,如果當前未配置終結點,則將顯示一個按鈕:

CM環境資訊

按一下此按鈕會開啟對話方塊:

CM Commerce端點

設定端點後(可選擇性地為分階段目錄支援設定驗證Token),端點會顯示在詳細資訊頁面上。 按一下「編輯」圖示會開啟相同的對話方塊,視需要可在其中修改端點。

CM環境資訊

通過Adobe I/OCLI

要通過Adobe I/OCLI將AEM與商務解決方案連接,請執行以下步驟:

  1. 使用Cloud Manager外掛程式取得Adobe I/OCLI

    查看AdobeCloud Manager文檔,了解如何下載、設定和使用Adobe I/OCLI以及Cloud Manager CLI插件

  2. 使用AEM as a Adobe I/O程式驗證Cloud ServiceCLI

  3. 在Cloud Manager中設定COMMERCE_ENDPOINT變數

    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
    

    有關詳細資訊,請參閱CLI文檔

    商務GraphQL端點URL必須指向商務的GraphQl服務,並使用安全的HTTPS連線。 例如:https://<yourmagentosystem>/graphql

  4. 啟用需要驗證的分段目錄功能(可選)

    注意

    此功能僅適用於Commerce Enterprise或Cloud Edition。 如需詳細資訊,請參閱Token型驗證

    在Cloud Manager中設定COMMERCE_AUTH_HEADER機密變數:

    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
    
秘訣

您可以使用下列命令列出所有Cloud Manager變數,以重複檢查:aio cloudmanager:list-environment-variables ENVIRONMENT_ID

借此,您就可以使用AEM Commerce作為Cloud Service,並可透過Cloud Manager部署專案。

配置儲存和目錄

CIF附加元件和CIF核心元件可用於連接到不同商務商店(或商店檢視等)的多個AEM網站結構。依預設,CIF附加元件部署時會搭配預設設定,連線至Adobe商務的預設商店和目錄(Magento)。

依照下列步驟,透過CIFCloud Service設定,針對專案調整此設定:

  1. 在AEM中前往「工具 — >Cloud Services-> CIF設定」

  2. 選擇要更改的商務配置

  3. 透過動作列開啟設定屬性

CIFCloud Services設定

可以配置以下屬性:

  • GraphQL客戶端 — 選擇配置的GraphQL客戶端以進行商務後端通信。 這通常應保持預設值。

  • 儲存檢視 — (Magento)儲存檢視識別碼。 如果為空,則使用預設的商店視圖。

  • GraphQL代理路徑 — AEM中的URL路徑GraphQL代理,用於代理向商務後端GraphQL端點的請求。

    注意

    在大多數設定中,預設值/api/graphql不得變更。 只有進階設定(不使用提供的GraphQL代理)才應變更此設定。

  • 啟用目錄UID支援 — 在商務後端GraphQL呼叫中,啟用對UID的支援,而非ID。

    注意

    Adobe商務(Magento)2.4.2已推出UID支援。請僅在您的商務後端支援2.4.2版或更新版本的GraphQL架構時啟用。

  • 目錄根類別標識符 — 儲存目錄根的標識符(UID或ID)

    注意

    從CIF核心元件2.0.0版開始,id的支援已移除,並改為uid。 如果您的專案使用CIF核心元件2.0.0版,則必須啟用目錄UID支援,並使用有效的類別UID作為「目錄根類別識別碼」。

上述組態供參考。 專案應提供自己的設定。

如需使用多個AEM網站結構並結合不同商務目錄的更複雜設定,請參閱商務多商店設定教學課程。

其他資源

本頁內容