ドキュメントCommerceAEM Assets統合

Commerce メタデータをサポートするようにAEM Assets プロジェクトを設定する

最終更新日： 2026年5月12日

作成対象：

  • User

AEM AssetsをCommerceのデジタルアセット管理システム （DAM）として使用する場合、assets-commerce パッケージをインストールすると、AEM オーサリング環境からCommerce製品の画像とビデオを管理できます。

AEM オーサリング環境からAEM Assets アセットを管理するために必要なパッケージコードとメタデータを使用してCommerce プロジェクトを設定するには、次の手順を実行します。

  1. assets-commerce パッケージの内容について説明します

  2. Commerce メタデータをサポートするようにAEM Assets プロジェクトを設定するには、インストール手順を実行します

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

Adobeは、Experience Manager Assets as a Cloud Service環境設定にCommerce名前空間およびメタデータスキーマリソースを追加するためのAEM Commerce パッケージコード assets-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属性。

  • 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 パッケージコード​の詳細については、readme ページを参照してください。

前提条件

assets-commerce パッケージコードをAEM Assets as a Cloud Service AEM環境にデプロイするには、次のリソースと権限が必要です。

製品ビジュアル

OpenAPI機能を備えた[SaaSのみ]{class="badge positive" title="Adobe Commerce as a Cloud ServiceおよびAdobe Commerce Optimizer プロジェクト（Adobeが管理するSaaS インフラストラクチャ）にのみ適用されます。"}のDynamic Mediaは、AEM Assetsを活用した商品ビジュアルのセルフサービスです。

  1. Cloud Managerに移動します。

  2. 目的の環境を選択します。

  3. OpenAPI機能を使用して​Dynamic Mediaを有効にする。

    OpenAPI機能を備えた​Dynamic Media ボタンがアクティブでない場合は、サポートチケットを開きます。

AEM Assets

[PaaSのみ]{class="badge informative" title="Cloud プロジェクト上のAdobe Commerce（Adobeで管理されるPaaS インフラストラクチャ）にのみ適用されます。"} AEM as a Cloud Serviceで、次の情報を記載したAdobe サポートチケットを送信します。

  • タイトル：Dynamic Media OpenAPIを有効にして、Adobe CommerceとAEM Assetsを完全に統合する

    • サポートチケットの内容：

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

サポートチケットを送信すると、AdobeはCloud Services環境でOpenAPI機能を備えたDynamic Mediaを有効にし、IMS クライアント IDなどの詳細を共有して、統合を進めることができます。

手順1:assets-commerce パッケージのインストール

  1. AEM Cloud Managerに移動し、プログラムを選択し、Adobe Commerceと統合する実稼動環境とステージング環境を作成します。

  2. ​ デプロイメントパイプライン ​を設定するか、パイプラインが選択した環境に変更をデプロイできることを確認します。

  3. 選択したプログラムのAdobe管理Git リポジトリ ​を複製します。

  4. GitHubから、AEM Assets Commerce リポジトリ ​からパッケージコードをダウンロードします。

  5. ​ ローカルのAEM開発環境から、ダウンロードしたコードを既存のAdobe管理リポジトリに手動でコピーします。

  6. プロジェクトのすべてのfilter.xmlとpom.xml filesで、<my-app>のすべての出現箇所をアプリ名に置き換えます。

NOTE
または、カスタムコードを​Maven パッケージとしてAEM Assets プロジェクト設定にインストールすることもできます。

  1. 変更を確定し、ローカル開発ブランチをCloud Manager Git リポジトリにプッシュします。

  2. AEM Cloud Managerから、​ パイプラインを使用してコードをデプロイし、AEM環境を更新します。

  3. 任意のアセットに移動し、そのプロパティを編集して変更を検証します。

    • デフォルトのメタデータスキーマには、「Commerce」タブが含まれています。

    • 製品SKUとEligible for Commerce フィールドが表示されます。

「Commerce」タブがプロパティに表示されない

Commerce タブがプロパティに表示されない場合は、メタデータスキーマエディターでタブを手動で作成する必要があります。

  1. メタデータスキーマエディターに移動します。

  2. 編集​をクリックして、デフォルトのメタデータスキーマフォームを変更します。

  3. 「Commerce」タブを作成し、選択します。

  4. Product コンポーネントを​Commerce タブにドラッグ&ドロップし、プロパティ commerce:skusにマッピングします。

  5. 役割を表示​および​ 順序を表示 ​のチェックボックスを選択します。

  6. checkbox コンポーネントを​Commerce タブにドラッグ&ドロップし、プロパティ commerce:isCommerceにマッピングします。 オプションとして​ Yes ​と​ No ​を定義します。

その他の問題が発生した場合は、​ サポートチケット ​を作成するか、AEM Assets Integrationの営業担当者にお問い合わせください。

手順2：オプション。 メタデータプロファイルの設定

AEM Assets オーサー環境で、メタデータプロファイルを作成して、Commerce アセットメタデータのデフォルト値を設定します。 次に、新しいプロファイルをAEM Asset フォルダーに適用して、これらのデフォルトを自動的に使用します。 この設定により、手作業を削減してアセット処理が合理化されます。

メタデータプロファイルを設定する場合、次のコンポーネントのみを設定する必要があります。

  • 「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. Commerce統合用のメタデータプロファイル Create。

    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. オプション。 承認済みのCommerce アセットをAEM Assets環境にアップロードするときに自動的に同期させるには、Basic タブの​ Review Status ​フィールドのデフォルト値をapprovedに設定します。

  9. アップデートを保存します。

メタデータプロファイルをCommerce assets ソースフォルダーに適用する

  1. 「​ Metadata Profiles」ページで、「Commerce統合プロファイル」を選択します。

  2. アクションメニューから、Apply Metadata Profiles to Folders​を選択します。

  3. Commerce アセットを含むフォルダーを選択します。

    Commerce フォルダーが存在しない場合は作成します。

  4. Apply​をクリックします。

次のステップ

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