ドキュメントCommerceAEM Assets統合

AEM Assets プロジェクトの設定

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

作成対象：

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

ここでは、「AEM Assetsの名前空間」、「メタデータスキーマ」、「Commerce」タブをAEM オーサリング環境で使用できるように、Commerce プロジェクトを設定する方法について説明します。 これらのリソースの背景については、AEM AssetsのCommerce メタデータ ​を参照してください。

AEM Assets プロジェクトを設定するには、次の2つのオプションがあります。

  • [推奨]{class="badge positive"} セルフサービス オンボーディング — AEM リリース 2026.5.26309以降では、環境変数を設定し、OpenAPI機能を使用してDynamic Mediaをアクティブ化することで、Cloud Managerでの統合を有効にします。 カスタムコードのデプロイメントは必要ありません。 Commerce統合（セルフサービス）を有効にするを参照してください。

  • 手動設定 — Cloud Manager パイプラインを使用してassets-commerce パッケージをデプロイします。 カスタムパッケージコードをデプロイする必要がある場合、または2026.5.26309より前のAEM リリースを使用している場合は、これらの手動ステップを使用します。 Assets-commerce パッケージを手動でインストールするを参照してください。

TIP
現在のAEM バージョンは、右上のメニュー（Help > About AEM）から確認できます。

Commerce統合（セルフサービス）を有効にする enable-aem-commerce-self-service

[​ サポート対象]{class="badge informative" title="サポート対象"} AEM リリース 2026.5.26309以降。

サポートされているAEM リリースでは、カスタムコードをデプロイせずに、Cloud ManagerからのCommerce統合を有効にします。 Commerceの名前空間、メタデータスキーマ、および​Commerce タブは、オーサーサービスでの統合を有効にすると自動的にプロビジョニングされます。

セルフサービスの前提条件

  • プログラムおよびデプロイメント マネージャーの役割を持つAEM Cloud Manager プログラムおよび環境へのアクセス。

  • リリース 2026.5.26309以降のAEM プログラム。

  • Commerce インスタンスの​IMS組織ID。

    Commerce インスタンスとAEM Assets オーサリング環境の両方が同じIMS組織にある必要があります。

手順1：プログラムと環境の作成

Cloud Managerでのプログラムの作成は、1つのウィザードプロセスです。プログラムとその環境は、複数の手順で設定され、最後にまとめて保存されます。

  1. Cloud Managerで、Add Program​を選択します。

  2. Set up for production​を選択し、プログラム名を入力してから、Continue​を選択します。

  3. Solutions & Add-ons ステップで、Dynamic Media​を含め、プロジェクトに必要なソリューションとアドオンを選択し、Continue​を選択します。

    Dynamic Mediaを選択したCloud Manager ソリューションとアドオンの手順 {width="600" modal="regular"}

  4. Add Environment ステップで、実稼動​および​ ステージング ​環境の名前を入力し、地域を選択します。

    実稼動環境とステージの詳細を含むCloud Manager Add environment ダイアログ ​ {width="600" modal="regular"}

  5. 環境を使用してプログラムを作成するには、Save​を選択します。

手順2:Commerce統合変数を有効にする

Cloud Managerで、手順1で作成した環境を開き、次の操作を行います。

  1. 「Configuration」タブを選択します。

  2. 次の値を持つ環境変数を追加し、Add​と​ Save ​を選択します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    フィールド 値
    名前 COMMERCE_INTEGRATION_ENABLED
    値 true
    適用されたサービス オーサー
    タイプ 変数

    COMMERCEINTEGRATIONENABLED変数がオーサーサービスに適用されたCloud Manager環境設定 {width="600" modal="regular"}

    環境が更新され、設定が適用されます。 環境ステータスが​ Running ​に戻るまで待ちます。

手順3:OpenAPI機能を使用したDynamic Mediaのアクティベーション

  1. 環境​General タブで、Dynamic Media​を見つけます。

  2. OpenAPI機能の横にある​を選択します。Click to activate

    Dynamic Media OpenAPI アクティベーションリンクを表示する「環境一般」タブ ​ {width="600" modal="regular"}

    アクティベーションはバックグラウンドで実行されます。 完了すると、Commerceとの連携の準備が整います。

    note
    NOTE
    Click to activate​が利用できない場合は、サポートチケットを開いて、OpenAPI機能を備えたDynamic Mediaを有効にします。

手順4：設定の検証

AEM Assets オーサー環境​に切り替えて、任意のアセットを開きます。 プロパティを編集し、デフォルトのメタデータスキーマに「Commerce」タブが含まれており、Product Data​および​Eligible for Commerce フィールドが表示されていることを確認します。

assets-commerce パッケージの手動インストール

NOTE
カスタムパッケージコードをデプロイする場合や、2026.5.26309より前のAEM リリースを使用している場合は、この手動メソッドを使用します。 サポートされているリリースでは、代わりにCommerce統合を有効にする（セルフサービス） ​を使用してください。

前提条件

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 Client IDなどの詳細を共有します。

インストール手順

  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にマッピングします。 オプションとして​ Yes ​と​ No ​を定義します。

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

メタデータプロファイルの設定（オプション）

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