AEM Assets中的Commerce中繼資料

最後更新： 2026年7月15日

主題：
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

建立對象：

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

Commerce中繼資料是AEM Assets與Commerce之間的合約。它會告知Commerce哪些資產適用於Commerce、其所屬產品，以及應如何使用或顯示。此中繼資料可讓AEM Assets整合正確對應及同步資產檔案。

Commerce中繼資料可啟用下列功能：

透過commerce:isCommerce欄位將資產標示為Commerce合格。
透過commerce:skus欄位將資產與一個或多個產品SKU建立關聯。
透過commerce:roles和commerce:positions欄位定義資產在Commerce中的顯示方式。
透過commerce:altTextStoreViews和commerce:altTextValues欄位新增由商店檢視鍵入的Commerce特定替代文字。
透過Commerce 索引標籤和結構描述表單，在AEM Assets屬性UI 中公開這些欄位。

IMPORTANT

Commerce專屬替代文字功能尚未透過自助上線提供。目前僅當您部署assets-commerce自訂程式碼套件時提供（請參閱手動安裝assets-commerce套件）。已規劃為即將發行的AEM版本提供原生支援。

若要在您的AEM專案中設定這些資源，請參閱設定AEM Assets專案。本主題的其他部分說明如何提供中繼資料。

AEM Commerce assets-commerce套件內容

Adobe提供assets-commerce AEM 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建立關聯。
  
  {width="600" modal="regular"}
- 自訂中繼資料型別commerce:roles和commerce:positions屬性會顯示資產在Commerce中的視覺化方式。
- 替代文字多欄位(Alt texts)中繼資料，讓編輯人員可以為每個Commerce存放區檢視程式碼輸入替代文字。多欄位會持續存在於兩個索引對齊的String[]屬性中：
  - commerce:altTextStoreViews — 儲存每一列的檢視程式碼。
  - commerce:altTextValues — 在與commerce:altTextStoreViews中的每個專案相同的索引處比對替代文字。
  使用外部比對器的App Builder實作可在轉換資產裝載時攔截這些屬性。這不會變更在目錄中指派產品影像或設定範圍的方式。請參閱AEM Assets中繼資料🔗中的本地化替代文字。
中繼資料結構表單具有Commerce索引標籤，其中包含用於標籤Commerce資產的Eligible for Commerce和Product Data欄位。此表單也提供在AEM Assets UI中顯示或隱藏roles和position欄位的選項。

AEM Assets中繼資料結構表單的 {width="600" modal="regular"}
範例已標籤並核准Commerce資產 equipment_6.jpg，以支援初始資產同步化。只有已核准的Commerce資產才能從AEM Assets同步到Adobe Commerce。