AEM AssetsのCommerce メタデータ

Commerce metadataは、AEM AssetsとCommerce間の契約です。 Commerceに対して、Commerceのアセット、そのアセットがどの製品に属しているか、その使用方法や表示方法について説明します。 このメタデータを使用すると、AEM Assets統合でアセットファイルを正しくマッピングおよび同期できます。

Commerce メタデータを使用すると、次の機能が有効になります。

  • commerce:isCommerce フィールドを使用して、アセットをCommerceの対象​としてマークします。
  • アセットをcommerce:skus フィールドを使用して1つ以上の製品SKU​に関連付けます。
  • Commerce​でのアセットの表示方法を、commerce:rolesおよびcommerce:positions フィールドを使用して定義します。
  • ストアビュー​でキーを設定したCommerce固有のalt テキストを、commerce:altTextStoreViewsおよびcommerce:altTextValues フィールドを介して追加します。
  • これらのフィールドを​​Commerce​ タブとスキーマフォームを使用してAEM Assets プロパティ UI ​で公開します。
IMPORTANT
Commerce固有の代替テキスト​機能は、​ セルフサービスオンボーディング ​を通じてまだ利用できません。 現在、assets-commerce カスタムコードパッケージをデプロイする場合にのみ提供されます(assets-commerce パッケージを手動でインストールするを参照)。 ネイティブサポートは、今後のAEM リリースで予定されています。

AEM プロジェクトでこれらのリソースを設定するには、AEM Assets プロジェクトの設定を参照してください。 このトピックの残りの部分では、メタデータの提供方法について説明します。

AEM Commerce assets-commerce パッケージの内容

Adobeには、Experience Manager Assets as a Cloud Service設定にCommerce名前空間とメタデータスキーマリソースを追加するためのassets-commerce AEM Commerce コードパッケージが用意されています。

このパッケージコードは、次のリソースをAEM Assets オーサリング環境に追加します。

  • Commerce関連のプロパティを識別するための​ カスタム名前空間Commerce

    • Adobe Commerce プロジェクトに関連付けられたCommerce アセットにタグ付けするためのラベル Eligible for Commerceを持つカスタムメタデータタイプ commerce:isCommerce

    • カスタムメタデータタイプ commerce:skusと、対応するUI コンポーネントを使用して​Product Data プロパティを追加します。 商品データには、Commerce アセットを商品SKUに関連付けるためのメタデータプロパティが含まれています。

      ​ カスタム製品データ UI コントロール ​ {width="600" modal="regular"}

    • Commerceでのアセットの視覚化方法を示すカスタムメタデータタイプ commerce:rolesおよびcommerce:positions属性。

    • 代替テキスト マルチフィールド (Alt texts) メタデータを使用して、エディターがCommerce ストアビューコードごとに代替テキストを入力できるようにします。 マルチフィールドは、インデックスで整列された2つのString[] プロパティに保持されます。

      • commerce:altTextStoreViews – 各行のビューコードを格納します。
      • commerce:altTextValuescommerce:altTextStoreViewsの各エントリと同じインデックスにあるalt テキストに一致します。

      外部マッチャーを使用するApp Builderの実装では、アセットペイロードの変換時にこれらのプロパティをインターセプトできます。 これは、カタログ内での製品画像の割り当てやスコープ設定は変更されません。 AEM Assets メタデータの​ ローカライズされたalt テキスト ​を参照してください。

  • Commerce アセットのタグ付け用のEligible for CommerceおよびProduct Data フィールドを含むCommerce タブを持つメタデータスキーマフォーム。 このフォームには、AEM Assets UIからrolesおよびposition フィールドを表示または非表示にするオプションも用意されています。

    AEM Assets メタデータスキーマフォームの「Commerce」タブ ​ {width="600" modal="regular"}

  • 最初のアセットの同期をサポートするために、​ サンプルにタグ付けして承認されたCommerce アセット ​ equipment_6.jpgが含まれています。 AEM AssetsからAdobe Commerceに同期できるのは、承認済みのCommerce アセットのみです。

NOTE
AEM Commerce パッケージコード​について詳しくは、GitHubのreadme ページを参照してください。

AEM Assets メタデータのローカライズされたalt テキスト

Alt texts​マルチフィールドは、対象となる画像を編集するときに、Commerce​タブのAEM Assets アセットメタデータエディターで使用できます。

IMPORTANT
ストアごとのビューの動作は、代替テキストにのみ適用されます。 AEM Assetsとの連携では、Adobe Commerceのストアビューごとに異なる商品画像が同期されません。 AEMの製品画像は、このリリース以前と同じギャラリー割り当て動作で引き続きCommerceに同期されます。

マルチフィールドには、Commerce ストアビューごとに1行が含まれます。 各行には2つの入力があります。

  • Store View Code — ストアビュー識別子(defaultまたはen_USなど)。

  • Alt Text – そのストアビューの代替テキスト(255文字に制限)。

追加のストアビュー用に行を追加するには、Add​を選択します。 行を削除するには、その行の​Delete アイコンを選択して削除します。

​ ストアビューコードと代替テキスト入力を含む代替テキストマルチフィールド ​ {width="600" modal="regular"}

保存すると、クライアント側の検証により、任意の行に空の​ Store View Code ​がある場合、または2つの行で同じストアビューコードが使用されている場合は、送信がブロックされます(大文字と小文字は区別されません)。

代替テキストエントリは、次の2つのインデックス整列String[] プロパティとしてJCR アセットメタデータに保持されます。

  • commerce:altTextStoreViews:各行のビューコードを格納します。
  • commerce:altTextValues: commerce:altTextStoreViewsの各エントリと同じインデックスにあるalt テキストに一致します。

これらのアセットがAdobe Commerceに同期すると、一致するストアビューコードのストアごとのビュー代替テキストが商品メディアギャラリーに書き込まれます。 基になる画像マッピングは変更されません。

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