DokumentationCommerceAEM Assets Integrationshandbuch

Migrieren von Mediendateien in das AEM Assets-DAM

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende

Sowohl Adobe Commerce als auch Adobe Experience Manager (AEM) bieten integrierte Funktionen zur Optimierung der Migration von Mediendateien von Commerce zum AEM Assets Digital Asset Management System (DAM). Sie können auch Mediendateien aus anderen Quellen migrieren.

Voraussetzungen

Kategorie
Anforderung
Systemanforderungen
  • AEM as a Cloud Service-Umgebung mit AEM Assets bereitgestellt
  • Ausreichende Speicherkapazität
  • Netzwerkbandbreite für große Dateiübertragungen
Erforderlicher Zugriff und Berechtigungen
  • Administratorzugriff auf AEM Assets as a Cloud Service
  • Zugriff auf das Quellsystem, in dem Mediendateien gespeichert werden (Adobe Commerce oder externes System)
  • Entsprechende Berechtigungen für den Zugriff auf Cloud-Speicher-Services
Cloud-Speicherkonto
  • AWS S3- oder Azure Blob Storage-Konto
  • Konfiguration von privaten Containern/Buckets
  • Authentifizierungsdaten
Source-Inhalte
Metadatenvorbereitung

Best Practices für die Migration

  1. Kuratieren Sie Assets vor der Migration, indem Sie nicht verwendete und doppelte Inhalte entfernen.

  2. Organisieren Sie Assets logisch nach Größe, Format oder Anwendungsfall.

  3. Erwägen Sie, große Migrationen in kleinere Batches aufzuteilen.

  4. Planung ressourcenintensiver Importe außerhalb der Spitzenzeiten

  5. Validieren der Metadatenzuordnung vor dem vollständigen Import

Migrations-Workflow

Befolgen Sie den Migrations-Workflow, um Mediendateien aus Adobe Commerce oder einem anderen externen System zu exportieren und in das AEM Assets-DAM zu importieren.

Schritt 1: Exportieren von Inhalten aus der vorhandenen Datenquelle

[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur)."}

Für Adobe Commerce-Händler kann das Remote-Speichermodul den Import und Export von Mediendateien erleichtern. Mit diesem Modul können Unternehmen Mediendateien mithilfe von Remote-Speicherdiensten wie AWS S3 speichern und verwalten. Informationen zum Einrichten des Remote-Speichers für Ihre Commerce-Instanz finden Sie unter Konfigurieren des Remote im Commerce-Konfigurationshandbuch.

Wenn Sie Mediendateien haben, die außerhalb von Adobe Commerce gespeichert sind, laden Sie sie direkt in eine der Datenquellen hoch, die von AEM as a Cloud Service unterstützt werden.

Schritt 2: Erstellen einer CSV-Datei für die Metadatenzuordnung

Erstellen Sie nach dem Exportieren der Mediendateien eine CSV-Datei, um diese Assets den für die Automatisierung erforderlichen Metadaten zuzuordnen. Die CSV sollte Felder für Produkt, Position und Rollenzuordnung), um die Abstimmung mit dem AEM Assets-Metadatenprofil sicherzustellen.

Geben Sie für jede Mediendatei, die Sie migrieren möchten, Werte für die Metadatenfelder im AEM Assets-Metadatenprofil für Commerce-Assets ​, wie in der folgenden Tabelle beschrieben.

Metadaten
Beschreibung
Wert
assetPath
Der vollständige Pfad, in dem das Asset im AEM Assets-Repository gespeichert wird.

Verwenden Sie den Pfad, um Unterordner zu erstellen und Commerce-Assets zu organisieren, z. B. content/dam/commerce/<brand>/<type>.
/content/dam/commerce/<sub-folder>/..<filename>
commerce:positions
Die Position/Reihenfolge des Assets in den Produktkatalogen
Mehrere numerische Werte, durch Pipe getrennt (siehe CSV-Datei)
commerce:isCommerce
Markierung, die angibt, ob das Asset in Commerce verwendet wird
Yes
commerce:skus
Mit diesem Asset verknüpfte Produkt-SKUs
Mehrere durch Pipe getrennte Zeichenfolgenwerte (siehe CSV-Datei)
commerce:roles
Die Rollen oder Typen von Bildern für das Asset (z. B. thumbnail, main image, swatch)
Mehrere Werte, durch Semikolons getrennt (z. B. „Miniaturansicht; Bild; Farbfeld_Bild; SMALL_IMAGE„)
CSV-Code

Verwenden Sie diesen CSV-Beispielcode, um die Datei in einem Code-Editor oder einer Tabellenkalkulationsprogramm wie Microsoft Excel zu erstellen.

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

Schritt 3: Massenimport von Assets in AEM Assets

Nachdem Sie die Metadatenzuordnungsdatei erstellt haben, verwenden Sie das Tool für den Massenimport von AEM Assets , um Ihre Assets zu importieren.

Im Folgenden finden Sie einen allgemeinen Überblick über die Verwendung des Tools.

  1. Melden Sie sich bei Ihrer AEM Assets as a Cloud Service-Autorenumgebung ​.

  2. Wählen Sie in der Ansicht Experience Manager-Tools die Option Assets > Bulk Import aus.

    AEM Assets-Authoring {width="600" modal="regular"}

  3. Wählen Sie aus den Massenimportkonfigurationen die Option Create aus, um das Konfigurationsformular zu öffnen.

    AEM Assets-Authoring {width="600" modal="regular"}

  4. Richten Sie die Konfiguration ein und speichern Sie sie.

    Sie benötigen:

    • Authentifizierungsdaten für Ihre Datenquelle
    • Der Zielordner in AEM Assets, in dem importierte Dateien gespeichert werden
    • Optional. Informationen über die MIME-Typen, die Dateigröße und andere Parameter zum Anpassen der Importkonfiguration
    • Der Pfad zur CSV-Datei für die Metadatenzuordnung, die Sie in die Cloud-Speicherinstanz hochgeladen haben.

    Ausführliche Anweisungen finden Sie unter Konfigurieren des Tools für den Massenimport im AEM Assets as a Cloud Service-Benutzerhandbuch.

  5. Verwenden Sie nach dem Speichern der Konfiguration die Tools für den Massenimport, um den Importvorgang zu testen und auszuführen.

Related Articles
Video-Demo zum Tool für den Massenimport
​> Tipps, Best Practices und Einschränkungen
​> Hochladen oder Aufnehmen von Assets mithilfe von APIs
recommendation-more-help
7d6707fb-4d59-44b9-ab2a-b69de39eb44d