ドキュメントCommerceAEM Assets 統合ガイド

AEM Assets DAMへのメディアファイルの移行

最終更新日： 2026年2月13日

作成対象：

  • User

Adobe CommerceとAdobe Experience Manager（AEM）の両方には、CommerceからAEM Assets デジタルアセット管理システム（DAM）​へのメディアファイルの移行を効率化する機能が組み込まれています。 他のソースからメディアファイルを移行することもできます。

前提条件

カテゴリ
要件
必要システム構成
  • AEM AssetsでプロビジョニングされたAEM as a Cloud Service環境
  • 十分なストレージ容量
  • 大規模なファイル転送に対応するネットワーク帯域幅
必要なアクセスと権限
  • AEM Assets as a Cloud Serviceへの管理者アクセス
  • メディアファイルが保存されているソースシステム（Adobe Commerceまたは外部システム）へのアクセス
  • クラウドストレージサービスにアクセスするための適切な権限
クラウドストレージアカウント
  • AWS S3またはAzure Blob Storage アカウント
  • プライベートコンテナ/バケット設定
  • 認証情報
Source コンテンツ
メタデータの準備

移行のベストプラクティス

  1. 未使用および重複するコンテンツを削除して、移行前にアセットをキュレートします。

  2. サイズ、形式、ユースケースごとに、アセットを論理的に整理します。

  3. 大規模な移行を小規模なバッチに分割することを検討する。

  4. オフピーク時に、リソース集約的なインポートをスケジューリングします。

  5. 完全に読み込む前に、メタデータマッピングを検証します。

移行ワークフロー

移行ワークフローに従って、Adobe Commerceまたは他の外部システムからメディアファイルを書き出し、AEM Assets DAMに読み込みます。

手順1：既存のデータソースからコンテンツを書き出す

[PaaSのみ]{class="badge informative" title="Cloud プロジェクト上のAdobe Commerce（Adobeで管理されるPaaS インフラストラクチャ）にのみ適用されます。"}

Adobe Commerceのマーチャントの場合、リモートストレージモジュール​を使用すると、メディアファイルの読み込みと書き出しが容易になります。 AWS S3などのリモートストレージサービスを使用して、メディアファイルを保存および管理できます。 Commerce インスタンスのリモートストレージを設定するには、Commerce設定ガイド​の​ リモートストレージの設定を参照してください。

Adobe Commerce以外にメディアファイルが保存されている場合は、AEM as a Cloud Serviceでサポートされている​ データソース ​のいずれかに直接アップロードします。

手順2：メタデータマッピング用のCSV ファイルの作成

各メディアファイルをCommerceの商品データにマッピングするCSV ファイルを作成します。 次のいずれかの方法を選択します。

  • Adobe Commerce （PaaS）: CLI コマンドを使用して、カタログからCSVを自動生成します
  • CSV ファイルを手動で作成する

CLIを使用したメタデータのエクスポート

[PaaSのみ]{class="badge informative" title="Cloud プロジェクト上のAdobe Commerce（Adobeで管理されるPaaS インフラストラクチャ）にのみ適用されます。"}

AEM Assets Integration CLI コマンドを使用すると、Commerce プロジェクトに保存されているプロダクトメディアファイルから、画像URL、位置、役割を含むメタデータ CSV ファイルを自動生成できます。

  1. AEM Assets統合モジュールがインストールされていることを確認するために、使用可能なコマンドを一覧表示します。

    code language-bash 
    bin/magento list aem

    カスタム拡張コマンドは、コマンドリストの先頭にあるaemの下に表示されます。

  2. AEM パスのプレフィックスを使用して、metadata export コマンドを実行します。

    code language-bash 
    bin/magento aem:assets:export:csv <AEM-path-prefix>

    <AEM-path-prefix>は、アセットがAEM Assets DAMに保存されるベース フォルダーパスです（例：/content/dam/commerce/）。

    code language-bash 
    bin/magento aem:assets:export:csv /content/dam/commerce/

    これにより、Commerce カタログ内の各商品アセットの画像URL、位置、役割を含むvar/export ディレクトリにmetadata.csv ファイルが作成されます。

CSVを手動で作成

Adobe Commerce以外に保存されているメディアファイルの場合は、CSV ファイルを手動で作成します。 列ヘッダー​ は、AEM Assets メタデータプロファイル ​で設定されたフィールド名 ​と一致する必要があります。 ファイルを作成したら、各メディアファイルのメタデータ値を行に入力します。

メタデータ
説明
値
assetPath
アセットがAEM Assets リポジトリに保存されるフルパス。

パスを使用してサブフォルダーを作成し、Commerce アセットを整理します（例：content/dam/commerce/<brand>/<type>）。
/content/dam/commerce/<sub-folder>/..<filename>
commerce:positions
製品ギャラリー内のアセットの位置/順序
パイプで区切られた複数の数値（「数値：複数」）
commerce:isCommerce
アセットがコマースで使用されているかどうかを示すフラグ
Yes
commerce:skus
このアセットに関連付けられた製品SKU
パイプで区切られた複数の文字列値（文字列：複数）
commerce:roles
アセットの役割または画像の種類（例：thumbnail、main image、swatch）
セミコロンで区切られた複数の値（例：「thumbnail; image; swatch_image; small_image」）
CSV コード

このサンプルのCSV コードを使用して、コードエディターまたはMicrosoft Excelなどのスプレッドシートアプリケーションでファイルを作成します。

code language-csv 
assetPath,commerce:positions{{Number: multi}},commerce:isCommerce{{String}},commerce:skus{{String: multi}},commerce:roles{{String: multi}}
/content/dam/commerce/sample1.jpg,1,Yes,sku1,thumbnail; image; swatch_image; small_image
/content/dam/commerce/sample2.jpg,1|1|1,Yes,sku1|sku2|sku3,thumbnail; image; swatch_image; small_image|image|image; small_change

ステップ 3:AssetsをAEM Assetsに一括読み込む

メタデータマッピングファイルを作成したら、AEM Assetsの一括読み込みツールを使用してアセットを読み込みます。

次に、ツールの概要を示します。

  1. AEM Assets as a Cloud Service オーサー環境にログインします。

  2. Experience Manager ツール ビューから、Assets > Bulk Import​を選択します。

    AEM Assets オーサリング ​ {width="600" modal="regular"}

  3. 一括読み込み設定から、Create​を選択して設定フォームを開きます。

    AEM Assets オーサリング ​ {width="600" modal="regular"}

  4. 設定を設定して保存します。

    次のようなものがあります。

    • データソースの認証情報
    • 読み込んだファイルが保存されるAEM Assetsのターゲットフォルダー
    • オプション。 インポート設定をカスタマイズするためのMIME タイプ、ファイルサイズおよびその他のパラメーターに関する情報
    • クラウドストレージインスタンスにアップロードしたメタデータマッピング CSV ファイルへのパス。

    詳細な手順については、AEM Assets as a Cloud Service ユーザーガイド​の「一括読み込みツールの設定」を参照してください。

  5. 設定を保存した後、一括読み込みツールを使用してテストし、読み込み操作を実行します。

Related Articles
一括読み込みツールのビデオ デモ
ヒント、ベストプラクティス、制限事項
APIを使用したアセットのアップロードまたは取り込み
recommendation-more-help
commerce-help-aem-assets-integration