文件CommerceAEM Assets整合指南

設定AEM Assets專案以支援Commerce中繼資料

Last update: Mon Dec 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：
  • CMS

建立對象：

  • 使用者

當您使用AEM Assets as a Digital Asset Management system (DAM) for Commerce時，安裝assets-commerce套件可讓您從AEM製作環境管理Commerce產品的影像和影片。

完成下列步驟，以使用必要的套件程式碼和中繼資料設定AEM Assets專案，以便從AEM製作環境管理Commerce資產：

  1. 瞭解 ​

  2. 完成安裝步驟以設定AEM Assets專案以支援Commerce中繼資料

AEM Commerce assets-commerce套件內容

Adobe提供AEM Commerce套件程式碼assets-commerce，將Commerce名稱空間和中繼資料結構資源新增至Experience Manager Assets as a Cloud Service環境設定。

此套件程式碼會將下列資源新增至AEM Assets編寫環境：

  • 自訂名稱空間，Commerce可識別Commerce相關屬性。

    • 具有標籤commerce:isCommerce的自訂中繼資料型別Eligible for Commerce可標籤與Adobe Commerce專案相關聯的Commerce資產。

    • 自訂中繼資料型別commerce:skus與對應的UI元件以新增​ Product Data ​屬性。 產品資料包含中繼資料屬性，以將Commerce資產與產品SKU建立關聯。

      自訂產品資料UI控制項 {width="600" modal="regular"}

    • 自訂中繼資料型別commerce:roles和commerce:positions屬性，用於顯示Commerce中資產的視覺化方式。

  • 中繼資料結構表單具有Commerce索引標籤，其中包含用於標籤Commerce資產的Eligible for Commerce和Product Data欄位。 此表單也提供在AEM Assets UI中顯示或隱藏roles和position欄位的選項。

    AEM Assets中繼資料結構表單的 Commerce索引標籤 {width="600" modal="regular"}

  • 範例已標籤並核准Commerce資產 equipment_6.jpg，以支援初始資產同步化。 只有已核准的Commerce資產才能從AEM Assets同步到Adobe Commerce。

NOTE
請參閱readme頁面，以取得有關​ AEM Commerce封裝程式碼 ​的詳細資訊。

先決條件

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

步驟1：安裝assets-commerce套件

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

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

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

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

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

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

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

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

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

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

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

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

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

如果​ Commerce ​索引標籤未出現在屬性中，您必須在中繼資料結構描述編輯器中手動建立一個。

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

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

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

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

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

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

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

步驟2：選擇性。 設定中繼資料設定檔

在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欄位拖曳至表單。

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

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

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

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

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

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

  9. 儲存更新。

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

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

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

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

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

  4. 按一下​Apply。

後續步驟

recommendation-more-help
7c668478-e331-4212-aded-e9afab74d1bd