文件CommerceAEM Assets整合

設定AEM Assets專案

最後更新： 2026年5月11日

建立對象：

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

本主題說明如何設定您的AEM Assets專案，好讓Commerce名稱空間、中繼資料結構描述和Commerce索引標籤可在AEM編寫環境中使用。 如需這些資源的背景資訊，請參閱AEM Assets中的Commerce中繼資料。

您有兩個選項可設定AEM Assets專案：

  • [建議]{class="badge positive"} 自助上線 — 在AEM版本2026.5.26309和更新版本上，透過設定環境變數並啟用具有OpenAPI功能的Dynamic Media來啟用Cloud Manager中的整合。 不需要部署自訂程式碼。 請參閱啟用Commerce整合（自助服務）。

  • 手動設定 — 透過Cloud Manager管道部署assets-commerce套件。 當您必須部署自訂套件程式碼時，或如果您使用2026.5.26309之前的AEM版本，請使用這些手動步驟。 請參閱手動安裝assets-commerce套件。

TIP
您可以從右上角功能表檢視目前的AEM版本： Help > About AEM。

啟用Commerce整合（自助服務） enable-aem-commerce-self-service

[支援]{class="badge informative" title="支援"} AEM版本2026.5.26309和更新版本。

在支援的AEM發行版本中，您無需部署任何自訂程式碼，即可從Cloud Manager啟用Commerce整合。 當您在Author服務上啟用整合時，會自動布建Commerce名稱空間、中繼資料結構描述和​ Commerce ​標籤。

自助服務必要條件

步驟1：建立方案和環境

在Cloud Manager中建立方案是一個精靈過程 — 方案及其環境會跨多個步驟進行配置，並在最後儲存在一起。

  1. 在Cloud Manager中，選取​Add Program。

  2. 選擇​Set up for production，輸入程式名稱，然後選取​Continue。

  3. 在​ Solutions & Add-ons ​步驟中，選取專案所需的解決方案和附加元件，包括​Dynamic Media，然後選取​Continue。

    已選取Dynamic Media的Cloud Manager解決方案和附加元件步驟 {width="600" modal="regular"}

  4. 在​ Add Environment ​步驟中，輸入​ 生產 ​和​ 暫存 ​環境的名稱，然後選取區域。

    Cloud Manager新增環境對話方塊，其中包含生產和中繼詳細資料 {width="600" modal="regular"}

  5. 選取​ Save ​以建立方案及其環境。

步驟2：啟用Commerce整合變數

在Cloud Manager中，開啟您在步驟1建立的環境，然後：

  1. 選取​ Configuration ​標籤。

  2. 使用下列值新增環境變數，然後選取​ Add ​和​Save：

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    欄位 值
    名稱 COMMERCE_INTEGRATION_ENABLED
    值 true
    已套用服務 作者
    型別 變數

    Cloud Manager環境設定，並將COMMERCEINTEGRATIONENABLED變數套用至作者服務 {width="600" modal="regular"}

    環境將更新以套用設定。 等到環境狀態回到​Running。

步驟3：使用OpenAPI功能啟動Dynamic Media

  1. 在環境​ General ​索引標籤上，找出​Dynamic Media。

  2. 在​可用的OpenAPI功能旁，選取​Click to activate。

    顯示Dynamic Media OpenAPI啟用連結的環境一般索引標籤 {width="600" modal="regular"}

    啟動會在背景執行。 完成時，環境已準備好進行Commerce整合。

    note
    NOTE
    如果​ Click to activate ​無法使用，請開啟支援票證以啟用具有OpenAPI功能的Dynamic Media。

步驟4：驗證設定

切換至​ AEM Assets作者環境 ​並開啟任何資產。 編輯其屬性，並確認預設中繼資料結構描述包含​ Commerce ​標籤，且​ Product Data ​和​ Eligible for Commerce ​欄位可見。

手動安裝assets-commerce套件

NOTE
如果您使用2026.5.26309之前的AEM發行版本，請使用此手動方法來部署自訂套件程式碼。 在支援的發行版本上，請改用啟用Commerce整合（自助服務）。

先決條件

若要將assets-commerce封裝程式碼部署至AEM Assets as a Cloud Service AEM環境，您需要下列資源和許可權：

產品視覺效果

[僅限SaaS]{class="badge positive" title="僅適用於Adobe Commerce as a Cloud Service和Adobe Commerce Optimizer專案（Adobe管理的SaaS基礎結構）。"}具備OpenAPI功能的Dynamic Media是自助式，提供AEM Assets所支援的產品視覺效果。

  1. 導覽至您的Cloud Manager。

  2. 選取所需的環境。

  3. 啟用​具有OpenAPI功能的Dynamic Media。

    如果​ 具有OpenAPI功能的Dynamic Media ​按鈕未啟用，請開啟支援票證。

AEM Assets

[僅限PaaS]{class="badge informative" title="僅適用於雲端專案上的Adobe Commerce （Adobe管理的PaaS基礎結構）。"}在AEM as a Cloud Service上，提交包含此資訊的Adobe支援票證：

  • 標題：啟用Dynamic Media OpenAPI以將Adobe Commerce與AEM Assets完全整合

    • 支援票證的內容：

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

提交支援票證後，Adobe會在您的雲端服務環境中啟用具有OpenAPI功能的Dynamic Media，並共用詳細資訊（例如IMS使用者端ID），以便您繼續整合。

安裝步驟

  1. 導覽至AEM Cloud Manager、選取方案，然後建立您要與Adobe Commerce整合的生產和中繼環境。

  2. 複製所選程式的Adobe受管理Git存放庫。

    Cloud Manager存放庫認證與複製命令 {width="600" modal="regular"}

    在Cloud Manager 管道​中，選取​ Access Repo Info ​以開啟​Repository Info。 複製​ URL ​或​ Git command line ​值，視需要產生存取密碼，然後使用您的Git使用者端在本機複製。

  3. 從GitHub下載AEM Assets Commerce存放庫的封裝程式碼。

  4. 從您的本機AEM開發環境，手動將下載的程式碼複製到現有的Adobe受管理存放庫。

  5. 在您的專案的所有filter.xml和pom.xml檔案中，以您的應用程式名稱取代所有出現的<my-app>。

    note
    NOTE
    或者，您可以將自訂程式碼作為​ Maven ​套件安裝至您的AEM Assets專案設定中。

  6. 提交變更，並將本機開發分支推送到Cloud Manager Git存放庫。

  7. 設定部署管道，或確認您的管道可以將變更部署到選取的環境。

    Cloud Manager管道 {width="600" modal="regular"}

    當管道存在時，開啟動作功能表(…) 至​Run、Edit、View/Edit variables​或其他動作 — 請參閱以上連結的Cloud Manager管道檔案。

  8. 從AEM Cloud Manager 使用管道來部署程式碼，以更新AEM環境。

  9. 前往任何資產並編輯其屬性以驗證變更：

    • 預設中繼資料結構描述包含​ Commerce ​索引標籤。

    • 會顯示產品SKU和Eligible for Commerce欄位。

Commerce索引標籤在屬性中不可見

如果​ Commerce ​索引標籤未出現在屬性中，您必須在中繼資料結構編輯器中，手動完成下列步驟：

  1. 導覽至中繼資料結構編輯器。

  2. 選取​ 編輯 ​以修改預設的中繼資料結構表單。

  3. 建立​ Commerce ​索引標籤並加以選取。

  4. 將​ Product ​元件拖放至​ Commerce ​標籤，並將其對應至屬性commerce:skus。

  5. 選取​ 顯示角色 ​和​ 顯示順序 ​的核取方塊。

  6. 將​ checkbox ​元件拖放至​ Commerce ​標籤，並將其對應至屬性commerce:isCommerce。 將​ 是 ​和​ 否 ​定義為選項。

如果您遇到任何其他問題，請建立支援票證或聯絡您的AEM Assets整合銷售代表以尋求協助。

設定中繼資料設定檔（選用）

在AEM Assets製作環境中，透過建立中繼資料設定檔，設定Commerce資產中繼資料的預設值。 若要自動使用這些預設值，請將新設定檔套用至AEM資產資料夾。 此設定可減少手動步驟，以簡化資產處理。

設定中繼資料設定檔時，您只需要設定下列元件：

  • 新增Commerce索引標籤。 此索引標籤會啟用範本新增的Commerce特定組態設定。

  • 將Eligible for Commerce欄位新增至Commerce索引標籤。

產品資料UI元件會根據範本自動新增。

定義中繼資料設定檔

  1. 登入Adobe Experience Manager作者環境。

  2. 在Adobe Experience Manager工作區中，按一下Adobe Experience Manager圖示以前往AEM Assets的作者內容管理工作區。

    AEM Assets製作 {width="600" modal="regular"}

  3. 選取槌子圖示，開啟「管理員」工具。

    AEM作者管理員管理中繼資料設定檔 {width="600" modal="regular"}

  4. 按一下​ Metadata Profiles ​開啟設定檔設定頁面。

  5. Create Commerce整合的中繼資料設定檔。

    AEM作者管理員新增中繼資料設定檔 {width="600" modal="regular"}

  6. 新增Commerce中繼資料的索引標籤。

    1. 按一下左側的​Settings。

    2. 按一下索引標籤區段中的​+，然後指定​Tab Name、Commerce。

  7. 將Eligible for Commerce欄位新增至表單。

    AEM作者管理員將中繼資料欄位新增至設定檔 {width="600" modal="regular"}

    • 按一下​Build form。

    • 將Single Line text欄位拖曳至表單。

    • 按一下​ Field Label ​新增標籤的Eligible for Commerce文字。

    • 在[設定]索引標籤上，將標籤文字新增至​欄位標籤。

    • 將預留位置文字設定為yes。

    • 在​ Map to Property ​欄位中，複製並貼上下列值

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. 選填。 若要自動同步處理上傳至AEM Assets環境的已核准Commerce資產，請在Basic索引標籤上將​ Review Status ​欄位的預設值設為approved。

  9. 儲存更新。

將中繼資料設定檔套用至Commerce資產來源檔案夾

  1. 從​ Metadata Profiles ​頁面，選取Commerce整合設定檔。

  2. 從動作功能表中選取​Apply Metadata Profiles to Folders。

  3. 選取包含Commerce資產的資料夾。

    建立Commerce資料夾（如果沒有）。

  4. 選取​Apply。

後續步驟

recommendation-more-help
commerce-help-aem-assets-integration