文件CommerceAEM Assets整合指南

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

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：
  • CMS

建立對象：

  • 使用者

若要在AEM Assets中管理Commerce資產檔案，請完成下列步驟，以使用所需的程式碼和中繼資料設定AEM Assets專案，以便從AEM製作環境管理Commerce資產。

  • 步驟1： ​安裝含有樣版程式碼的AEM專案範本，將Commerce名稱空間和中繼資料結構描述資源新增至Experience Manager Assets as a Cloud Service環境設定。
  • 步驟2： ​設定要套用至Commerce資產檔案的中繼資料設定檔

將程式碼加入您的AEM專案

Adobe提供AEM Commerce範本assets-commerce，將Commerce名稱空間和中繼資料結構描述資源新增至Experience Manager Assets as a Cloud Service環境設定。 將此程式碼作為​ Maven ​套件部署至您的環境。 然後，在AEM Assets製作環境中設定Commerce中繼資料，以完成設定。

範本將下列資源新增至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樣板 ​的詳細資訊。

先決條件

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

安裝commerce-assets封裝

  1. 如有需要，可從AEM Cloud Manager建立AEM Assets專案的生產和中繼環境。

  2. 視需要設定部署管道。

  3. 從GitHub，從AEM Commerce範本下載程式碼。

  4. 從您的本機AEM開發環境，將自訂程式碼作為Maven套件安裝在您的AEM Assets環境設定中，或手動將程式碼複製到現有的專案設定中。

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

  6. 從AEM Cloud Manager 部署您的程式碼以更新AEM環境。

選填。 設定中繼資料設定檔

在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。

下一步

僅[PaaS]{class="badge informative" title="僅適用於雲端專案上的Adobe Commerce (Adobe管理的PaaS基礎結構)。"} 安裝Adobe Commerce套件

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