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 で公開します。
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に関連付けるためのメタデータプロパティが含まれています。 {width="600" modal="regular"}
-
Commerceでのアセットの視覚化方法を示すカスタムメタデータタイプ
commerce:rolesおよびcommerce:positions属性。 -
代替テキスト マルチフィールド (Alt texts) メタデータを使用して、エディターがCommerce ストアビューコードごとに代替テキストを入力できるようにします。 マルチフィールドは、インデックスで整列された2つの
String[]プロパティに保持されます。commerce:altTextStoreViews– 各行のビューコードを格納します。commerce:altTextValues—commerce:altTextStoreViewsの各エントリと同じインデックスにあるalt テキストに一致します。
外部マッチャーを使用するApp Builderの実装では、アセットペイロードの変換時にこれらのプロパティをインターセプトできます。 これは、カタログ内での製品画像の割り当てやスコープ設定は変更されません。 AEM Assets メタデータの ローカライズされたalt テキスト を参照してください。
-
-
Commerce アセットのタグ付け用の
Eligible for CommerceおよびProduct Dataフィールドを含むCommerce タブを持つメタデータスキーマフォーム。 このフォームには、AEM Assets UIからrolesおよびpositionフィールドを表示または非表示にするオプションも用意されています。 {width="600" modal="regular"}
-
最初のアセットの同期をサポートするために、 サンプルにタグ付けして承認されたCommerce アセット
equipment_6.jpgが含まれています。 AEM AssetsからAdobe Commerceに同期できるのは、承認済みのCommerce アセットのみです。
AEM Assets メタデータのローカライズされたalt テキスト
Alt textsマルチフィールドは、対象となる画像を編集するときに、CommerceタブのAEM Assets アセットメタデータエディターで使用できます。
マルチフィールドには、Commerce ストアビューごとに1行が含まれます。 各行には2つの入力があります。
-
Store View Code — ストアビュー識別子(
defaultまたはen_USなど)。 -
Alt Text – そのストアビューの代替テキスト(255文字に制限)。
追加のストアビュー用に行を追加するには、Addを選択します。 行を削除するには、その行のDelete アイコンを選択して削除します。
保存すると、クライアント側の検証により、任意の行に空の Store View Code がある場合、または2つの行で同じストアビューコードが使用されている場合は、送信がブロックされます(大文字と小文字は区別されません)。
代替テキストエントリは、次の2つのインデックス整列String[] プロパティとしてJCR アセットメタデータに保持されます。
commerce:altTextStoreViews:各行のビューコードを格納します。commerce:altTextValues:commerce:altTextStoreViewsの各エントリと同じインデックスにあるalt テキストに一致します。
これらのアセットがAdobe Commerceに同期すると、一致するストアビューコードのストアごとのビュー代替テキストが商品メディアギャラリーに書き込まれます。 基になる画像マッピングは変更されません。