文件CommerceAEM Assets整合

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

最後更新： 2026年5月11日

建立對象：

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

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

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

  1. 瞭解assets-commerce封裝內容

  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相關屬性。

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

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

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

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

    • 替代文字多欄位(Alt texts)中繼資料，讓編輯人員可以輸入Commerce存放區檢視程式碼作為關鍵字的替代文字。 這不會變更在目錄中指派產品影像或設定範圍的方式。 檢視AEM Assets中繼資料🔗中的替代文字。

  • 中繼資料結構表單具有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
請參閱GitHub上的readme頁面，以取得有關​ AEM Commerce封裝程式碼 ​的詳細資訊。

AEM Assets中繼資料中的替代文字

當您編輯符合資格的影像時，Alt texts​多欄位可在​ Commerce ​索引標籤上的AEM Assets資產中繼資料編輯器中使用。

IMPORTANT
每個商店的檢視行為僅適用於替代文字。 AEM Assets整合不會針對每個Adobe Commerce商店檢視同步處理不同的產品影像。 來自AEM的產品影像會持續同步至Commerce，並且其相簿指派行為與此版發行前相同。

多欄位在每個Commerce存放區檢視中都包含一列。 每一列有兩個輸入：

  • Store View Code — 存放區檢視識別碼（例如default或en_US）。

  • Alt Text — 該商店檢視的替代文字，限製為255個字元。

選取​ Add ​為其他存放區檢視新增更多列。 若要移除列，請選取該列上的​ Delete ​圖示以將其移除。

Alt文字多欄位，包含儲存區檢視碼和Alt文字輸入 {width="600" modal="regular"}

當您儲存時，如果任何資料列有空白的​Store View Code，或如果兩個資料列使用相同的存放區檢視代碼（不區分大小寫），使用者端驗證會封鎖提交。

替代文字專案會保留在JCR資產中繼資料中，作為兩個索引對齊的String[]屬性：

  • commerce:altTextStoreViews：儲存每一列的檢視程式碼。
  • commerce:altTextValues：在與commerce:altTextStoreViews中的每個專案相同的索引處比對替代文字。

當這些資產同步至Adobe 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支援票證：

  • Title：啟用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：安裝assets-commerce套件

  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整合銷售代表以尋求協助。

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

    • 按一下​ 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